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MCS Overview 



a What is MCS 

I Multics Communications System 

I Software to transfer data to/from terminals or other devices connected via 
communications lines 

I Sometimes called MCM: Multics Communications Manager 

I Design is generalized, table -driven 

I Especially good at supporting diverse asynchronous terminals 
I In this course most of the major MCS topics are covered 
I Administration 

I CMF, TTF, FNP images 

I Use 

I All Ring 0 interfaces to MCS functions 
I Internals 

I Ring 0 and FNP 
I Metering and Debugging 

I Ring 0 and FNP 

I There are certain topics within MCS or related to MCS that will not be 
covered in detail 

I Details of various protocols 

I HASP, X.25, etc. 

I Video System 

I I/O Daemon software 

i FNPs other than 355/6670 families 
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a Standard Communications Concepts 

Some communications concepts that are not necessarily specific to Multics need 
to be understood in order to understand MCS. 

I ASCII Character Set 

I Multics was one of the first systems to use ASCII standard 

I Character sizes 

I 128 7 -bit characters defined by standard 

I Usually transmitted as 8 -bit characters 

I 7 data bits plus 1 parity bit 

I Stored in 9 -bit bytes in Multics 

I 1 data bits plus 2 zero bits 
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7 -bit Character Stored in 9 -bit Byte 
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I Control characters 

I Some ASCII codes are non-printing and have special uses 
I Multiple names are sometimes confusing 

I X-OFF, DC3, Control- S, A S, \023 

I X-ON, DCI, Control-Q, A Q, \021 
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I ESC, Control- [, A [, \033 
I LF, NL, Control- J, A J, \012 

I BS, Control -H, A H, \010 

I Formfeed, NP, Control-L, A L, \014 

I PAD, DEL, Rubout, \177 

I NUL, Control -<§, A @, Control-SP, A SP, \000 
I BREAK (QUIT) is not an ASCII character 

I BREAK Is a line condition discussed later under RS232 
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ASCII Character Set Chart 
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I Baud Rate 

I Discrete signal events transmitted per second 
J Usually but not always equal to bits per second (bps) 
I New 2400 bps modems are 1200 baud 
I Line protocol 

I Parameters of a line that user can't change 
I Parameters that user can change are called terminal protocol 
I A line can have several levels of protocols that: 
I Synchronise data transmission and reception 

I Ensure correct and complete .reception of data by flow control 
and acknowlegement of received data. 

I Multiplex data for different devices on single line 
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Conmunications Protocols Supported by Multics 



SERIAL BINARY 



I I / 
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j j j and Data 

I I \ 



KERMIT XMODEM BISYNC 



I ! / 

| | j Reliability 
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i I 



[15 B^r-c 



VIP 



MCS Overview 



Standard Communications Concepts 



F86 Page 1-9 



I Asynchronous Protocols 

I Data comes in bit by bit as changing signal on a wire with one 
voltage to represent logic 0 and another to represent logic 1 

I Two things need to be synchronized between the sender and the 
receiver: 

I When to sample each bit (synchronising clocks) 

I Which bit is the first in data (first in each character) 

I Asynchronous protocols resynchronize both for each character 

I Start bit used to signal beginning of first bit of character 

I Transition from idle state (logic 1) to start bit (logic 0) 

I One or two stop bits used to put line in idle state at end of 
each character 

I 10 bits used to send 1 character, so BPS - 10 CPS, efficiency 
70% 
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Asynchronous Protocol 
Problem: Synchronisation of clocks and of data start 

"6" = 066 octal - 0110110 binary - 00110110 with even parity 
At 300 baud, 1/300 sends between bits. 

Bits sent to send ASCII M 6 n 

> Message Flow > 

| P | D6 | D5 | D4 | D3 | D2 | Dl | DO | 
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P D6 D5 D4 D3 D2 Dl DO 
Sampling needed every 1/300 second to read received bits. 
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Asnynchronous Protocol 
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Asynchronous throughput 
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I In Multics, maximum speed for asynchronous lines is 19,200 bps 
I Protocol used by typical asynchronous terminals is called ASCII 

I Could be used by non- ASCII, e.g. EBCDIC, terminals 
I Multics used to support other asynchronous protocols 

I 2741 

I 1050 

I ARDS 

I Standard asynchronous connections provide no guarantee of reliability 

I The Kermit and XMODEM protocols sit on top of the asynchronous 
protocol 

J They provide flow control, error detection, acknowledgement, for 
the purposes of reliable file transfer 

I Synchronous Protocols 

I Again, need to synchronize clocks and data 

I Clocks are synchronized by extra signal 

I Data synchronization is per -block 

I Two or more SYNCcharacters are sent to indicate start of block 

I Typical synchronous protocol adds information at beginning and end of 
each block 

I Block length, checksum, etc. 

J Typical synchronous protocol requires acknowledgement of each block 
from receiver 

I Throughput depends on details of protocol, but is higher than 
asynchronous for medium to high volumes of data 
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Typical Synchronous Protocol 
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Typical 
Values : 



<-Sync-> <-Hdr-> <• 



•Data- 



100 



•> <-Trl-> 



2 Sync bytes 
2 Header bytes 
2 Trailer bytes 

100 data bytes 8 Overhead bytes 

Throughput: 100/108 - 93% 
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I In Multics, maximum speed for asynchronou s lines is 72 KB 
I Multics supports a variety of synchronous protocols: 

i BSC 

I HASP 

I 2780/3780 

I 3270 

I G115 

I VIP 

I Polled VIP 
I HDLC 
I X.25 
I Multiplexer 

I There are many ways to have several logical connections over a single 
physical connection 

I This is known as a multiplexed line 

I For some types of multiplexed lines MCS can perform the work of 
multiplexing/demultiplexing the logical connections 

I The idea of multiplexing is generalized in MCS to include an 
arbitrary number of levels of multiplexing 

I MCS considers the FNP to be a multiplexer because it has many 

channels connected to it and multiplexes all of that information over 
a single physical connection (the DIA) 

I Modem 

I MOdulator/DEModulator 

I Allows data to be transmitted over phone lines 
I Many different standards for modems 
I Modems may be full or half duplex 

I Not to be confused with echoplex 
I RS232/V24 
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I Defines connection between 

I Data Terminal Equipment (DTE) : Terminal or computer 
I Data Circuit- terminating Equipment (DCE) : Modems 

I Connection is by 25 pin connectors and cables 

I Diagram shows the pins used by Multics in asynchronous connections 
I Synchronous connection also uses pin 24 for timing (clock signal) 
I Used for all Multics protocols except HDLC r 
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CCITT 
Circuit 

No. Name Norn Description 

101 GND TP Ground 

102 GND TS Ground 
- -> 103 TX ED Transmission 
<- 104 RX RD Reception 
--> 105 RTS DPE Request to send 
<- 106 CTS PAE Clear to send 
<=- 107 DSR PDP Dataset ready 
<-- 109 CD DP Carrier Detect 
--> 108 DTR CPD Data terminal ready 



Description 

Terre de protection 
Terre de signalisation 
Emission de donnees 
Reception des donnees 
Demande pour emettre 
Pret a emettre 
Poste de donne pret 
Detection de la porteuse 
Connectez le poste de donnees 



MALE 



\ - - / 

\123456789 10 11 12 13 / 

\ / 
\ 14 15 16 17 18 19 20 21 22 23 24 25 / 

\ / 



FEMALE 



\ / 
\ 13 12 11 10 9 8 7 6 5 4 3 2 1/ 

\ / 
\ 25 24 23 22 21 20 19 18 17 16 15 14 / 

\ / 
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Modem Dialup Sequence 



TTY Modem 
DTE DCE 

g (TX) 2 > 2 

f (RX) 3 < 3 

c (RTS) 4 > 4 

e (CTS) 5 < 5 

d (DSR) 6 < 6 

e (CD) 8 < 8 

c (DTR) 20 - > 20 



Modem FNP 
DCE DTE 

2 < 2 (TX) f 

3 - > 3 (RX) g 

4 <- 4 (RTS) b 

5 > 5 (CTS) e 

6 > 6 (DSR) a 

8 > 8 (CD) e 

20 < 20 (DTR) b 



To listen to a line, the FNP raises RTS (pin 4) and DTR (pin 20) 
and then waits for CTS (pin 5), DSR (pin 6) and CD (pin 8) to go 
high. 

The FNP detects a hangup if DSR (pin 6) or CD (pin 8) drop for more 
than one second. If CTS (pin 5) drops, the FNP suspends output. 



Scenario : 



a) Modem on FNP is powered on. 0$ <^ 

b) FNP boots and listens to the line, f r97i 0*)^ 

c) The terminal is turned on. sT**.!*?* £T 

d) The terminal's modem is turned on. 

e) The telephone call is made and the modems are connected. f<\>S*<s ^C^S C JD^ 

f) Multics sends the login banner. ^ 

g) User types login line. 



1 >C^ J , 
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I Break/Interrupt 

I Out -of -band signal 

for 100 to 600 msec 

I Line Driver 

I Also known as short-haul modems or point-to-point modems 
I Inexpensive replacement for modems for point-to-point connections 
I No real standards 
I Direct Connect 

I For very short distances, a direct RS232 connection is possible 
I Very inexpensive replacement for modems 
I Theoretically limited to about 50' 

I Practically can be extended much further 
I Known as hardwired connection, null modem, modem bypass 
I Each DTE must be made to think it is connected to a DCE 
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6 -WIRE DIRECT CONNECT 



TTY FNP 
DTE DTE 
(PG) 1 1 

(SG) 7 - -- 7 

(TX) 2 \ / 2 

\ 

(RX) 3 / \ 3 

(RTS) 4 --| |-- 4 

I I 

(CTS) 5 --{ j-- 5 

(DSR) 6 —I 6 

I I 
(CD) 8 --|----\ /----!-- 8 

\ 

(DTR) 20 / \ 20 

5 -WIRE DIRECT CONNECT 



FN? 
DTE 
1 

7 

"A / 2 

\ 

"-/ \ 3 

|-- 4 
I 

• I" 5 
6 

I 

-A /----!-- 8 

\ 

---/ V- 20 





TTY 




DTE 


(PG) 


1 


(SG) 


7 


(TX) 


2 


(RX) 


3 


(RTS) 


4 


(CTS) 


5 


(DSR) 


6 


(CD) 


8 


(DTR) 


20 
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Direct -Connect Dialup Sequence 







TTY 




FNP 










DTE 




DTE 






d 


(TX) 


2 


— A A-- 


.... 2 


(TX) 


d 








\ 








c 


(RX) 


3 = 


----/ \— 


.... 3 


(RX) 


c 


D 




4 | 
I 




■ 


/"DfC \ 

(Klb) 


a 


D 




1 




1 

1 _ „ 5 




a 


a 


(DSR) 


6 

i 




1-- 6 


(DSR) 


b 


a 


(CD) 


8 --| 


\ /— 


1 

-|" 8 


(CD) 


b 








\ 








b 


(DTR) 


20 


----/ \— 


.... 20 


(DTR) 


a 



Scenario: 

a) FNP boots and listens to the line. 

b) The terminal is turned on. 

c) Multics sends the login banner. 

d) User types login line. 



4 -WIRE DIRECT CONNECT 



(PG) 

(SG) 

(TX) 

(RX) 

(RTS) 

(CTS) 

(DSR) 

(CD) 

(DTR) 



TTY 
DTE 
1 



7 - 

2 - 

3 - 

4 - 

5 - 

6 - 

8 - 
20 



\ A 
\ 

■/ V 



/----I 



FNP 
DTE 
1 

• 7 
- 2 

■ 3 

• 4 

• 5 

■ 6 

• 8 
20 
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I Line Monitor 

I Monitor RS232 signals and display transmitted and received data 
I Breakout Box 

I Monitor RS232 signals 

J Also known as a Blue Box. 



Line Monitors , Blue Boxes 
Phone 

DTE RS232 DCE lines DCE RS232 DTE 



I I V | I V | | V | | 

J Terminal | -+ +- j Modem | | Modem | -+ +- | Computer | 

I I I I I I I i I I I I 

LI LI 

| Blue Box/ | | Blue Box/| 

| Line Mon. | j Line Mon. | 

I I I I 
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h Standard Multics Concepts 

I Ring 0 Supervisor 

I When a process requires supervisor services , it executes supervisor 
programs 

I Three ways to enter supervisor code: 
I Call 

I Explicit request for supervisor services 

I For example, create a segment, make a segment known, write 
data to a terminal, read input from a terminal, etc. 

I Fault 

I Faults are caused by conditions within the CPU 
I Implicit request for supervisor services 
I For example, page faults, segment faults, linkage faults 
I Interrupt 

I Interrupts are caused by conditions outside the CPU 
I Perform a service for another process 

I For example, handle completion of a disk read, interrupt 
from FNP, etc. 

I Initializer/Answering Service 

I The Initializer process has a number of tasks to perform 

I Listen to login lines 

I Execute operator commands 

I Load FNPs, other multiplexers 

I Etc. 
I Block/Wakeup 

\ Mechanism used to wait for events of unknown duration 

I Terminal I/O, tape I/O 

I Process is in user ring while blocked 
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I When event occurs , some other process sends a wakeup to blocked 
process 

I Compare with Wait/Notify, to wait for events of short duration 
I Disk I/O, system locks 
I Process is in ring 0 while waiting 

I When event occurs, some other process notifies waiting process 
by changing its Traffic Control state 
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a MCS Parts 

I FNP 
I Ring 0 
I Ring 4 



MCS Parts 
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MCS Parts 



Central 
System (CS) 

Multics 

Host 



Direct 

Interface 

Adapter 



355 



Communica- 
tion lines 

Communica- 
tion 
Devices 



RING 4 



hcs 



RING 0 



DIA 



I/O Modules, e.g. tty_ 
B 1 o ck/W akeup 
PL/I: >sll, >sss 

Answering Service 
FNP loading, dumping 
PL/I: >tools 



Data conversion, translation 
Manage wired buffer space TTY-ftof^ 
Communicate with FNP 

Handle FNP interrupts . 
De -multiplexing O <>Jk?r sp?<~s 4**4 cr\ K J sUM o 
PL/I & ALM: Hardcore (MST) 



FNP 



term 



mpx 

/ \ 
term term 



term 



Transfer of data over DIA 'f^l^J^ 

Buffer space management 

Echoing . 

Padding j#J. BJ > Ufh^YSjU* - <Vv ™ t, 

Flow control £>r 43yWc X °^ *"c^tf 

Tell CS state of channels 

Send terminal input to CS 

Send output from CS to terminal 

Modem control (RS-232, e.g.) 

Interval timers 

Format, interpret synchronous msgs 
MAP355: loaded from Multics into FNP 
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I The Ring 0 and FNP parts of MCS are covered in this course 

I The MCS functions made available to the user by Ring 0 and the FNP 
will be explained using the tty_ I/O module as an example 

I Following diagram shows the relationships of the various I/O modules 
for terminal I/O 

I tty_ uses the same hcs_ interface as other I/O modules, and therefore 
makes a good example 



I/O Module Dependencies 



I 

+-=--- bisync_ < 
hcs_ <---+ 

+ gH5_ <-- 

I 

+----- tty_ <--- 
I 

-j — = . „ tc_io_ 
I 

+----- emacs 



hasp_workstation_ <• 
hasp_host_ <-------. 

ibm3270 



■+ 
I 

-+ 



+--ibm2780 _/3780_ <--+- 
■-+ " | 

+- ---- — -+ 

+ 

I 

■+-- — ------- + 

I 

+----- kermit 
I 

+----- xmodem io 



remote_input_ 
- remote_punch_ 

remote_teleprinter_ 
remote_printer_ 
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a FNP Hardware Description 

I Up to 8 FNPs can be configured 
I Names 

I FNP 

I Front -End Network Processor 
I Front End 
I Fuh-Nup 
I Datanet 
I DN355 
I 355 
I 6670 
I 6678 
I 18x 
I FEP 
I MPX 
I Model Numbers 
I 355 

I The original Multics FNP 

I Has given its name to many of the MCS programs 
I Limited to 32K memory 
I No longer supported as of MRU 
I 6632 

I A newer version of the 355 
] Limited to 32K memory 
I No longer supported as of MRU 
I 6670 

I Level -6 based, emulates 355 
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I Up to 256K memory with extended memory addressing 
I Two models 

J 6678 with cache memory 

I 6651 without cache 

I Architecture 

I Has same basic architecture as Multics: IOM, SCU+MEM, CPU 
I Peripherals connected to IOM 

I DIA 

I HSLAs 

FNP Architecture 



+-------+ 

| CPU +-- 

I I 

I I 

I I 
+-------+ 



Multics 

+ + 

•+ SCU +• 

1+ + 1 

|i MEM || 

1+ + 1 
+ ---+ 



FNP IOM Channels: 



FNP Console 
FNP Reader 
FNP printer 



DIA 

HSLA 0 
HSLA 1 
HSLA 2 
9-14 LSLAs O^Sc^-^ 
15 Clock 



IOM 



- -DIA- 



FNP 



IOM 



-+ 

+ • 



+• 

-+ 

I 
I 



+-+-+-+ 
| +--- 
+-+- — -+ 
I HSLA | 



+- + + 

■+ SCU +--+ CPU 
|+---+| | 
I I MEM | j | 
| 

+ + + 

+ 

+- -+ + 

I HSLA I 



+-+=+»++ +-+-+-++ 
+- - -+-+-+- +-+-+- ■ 



-+ 



1 I I 
I I I 



I I I 

i i i 



Terminals 
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I Data and Instruction Formats 
I 18 -bit words 

I I/O commands also know about 36 -bit words 
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STORE REFERENCE INSTRUCTION FORMAT 



0 0 0 0 0 0 1 

0_1_2_3 8_9 7 

■ i i i i 

III I l 

| I | TAG | Opcode | Delta | 



1 2 



INDEX REGISTER (Xn) UNPAGED ADDRESS 

0 0 0 1 
0_2_3 7 

1 I I 
| TAG | Address | 

I I I 



3 15 



INDEX REGISTER (Xn) PAGED ADDRESS 

0 0 0 0 1 1 
0_2_3 9_0 7 

1 I "~™ I ~ I 
| TAG | Page No . | Offset | 



8 
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ACCUMULATOR REGISTER (A) 



0 1 
0 7 

! 

1 A 

i 

18 



QUOTIENT REGISTER (Q) 

0 1 
0 7 



18 



ACCUMULATOR-QUOTIENT REGISTER (AQ) 

0 11 3 

0 7_8 5 

! ! 

| Even Word (A) | Odd Word (Q) 



18 18 
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I Extended Memory Addressing 

I So-called paging is used to address beyond 32K 

I Difficult to program, so only certain types of data are stored in 
extended memory 

I No programs in extended memory 
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FNP Extended Memory Addressing 



Page Table 
+ + 

4000 | A=0+-- 
+ -+ 

4001 | A-0+-- 
+ + 

4002 | A-0+-- 
+-- + 

I - I 
I • I 

+ + 

4175 I. A-0+-- 
+ + 

4176 | A-1+-- 
+ + 

4177 j A-1+-- 
+------+ 



Memory 



+- 

I 

■>+ 
I 

+- 
I 

->+ 
I 

+- 

i 

->+ 
I 

+■ 



000000-000377 
Page 0 



000400-000777 
Page 1 



001000-001377 
Page 2 



•>+ 
I 

+■ 
I 



076400-076777 
Page 175 



077000-077377 
Page 176 



■+ 



| 077400-077777 
I Page 177, end of 32K 
+ --- 

I 

| 100000-100377 

| Page 200, start extended mem 



+■ 
i 

•>+ 



100400-100777 
Page 201 



+- 
I 

■>+ 
I 

+- 



177000-177377 
Page 376 



177400-177777 
Page 377, end of 64K 
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FNP Address Calculation Example 1 
Reference To Address In Low-Order Memory Using Non-Paged Addressing 

c (x2)= 076700; c(x3)»077240; c(475)=004000 ; c(4175)=000000 ; c(4176)=133040 




Instruction: 


Ida 1,2 


2(017 


| 0 | 0 | 1 


1 1 

010 | 000 | 111 


1 1 1 

| 000 | 000 | 001 


I (Tag | Opcode 
1 " 1 


| Delta 


0 | 10 | 000111 


| 000000001 


0p>2 | 07 


1 001 ^ 


\ / 


\ / 




I 
I 

V 



0 



X-register 2 
| 6 | 7 



0 



1 ooo i in i no i in i ooo j ooo i 

+.-_-.....--._..._._ — .....__.__._+ 

I Tag | 15 -bit address | 

I I I 

| 0 | 76700 | 
+-------- + 





Final 


Address 




o 


7 | 6 


| 7 | 0 


1 
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FNP Address Calculation Example 1 
Reference To Address In Low- Order Memory Using Paged Addressing 



c (x2)=076700; c(x3)=077240 ; c(475)=004000; c(4175)=000000 ; c(4176)=133040 

+ - + 

I 

+- - 



Instruction: Ida 1,2 



| 2 | 0 | 7 

I 1 I 

| 010 | 000 I 111 



+ — 

1 I 


|Tag 


Opcode | 


Delta 


1 

1 o 


1 io 


000111 | 


000000001 


1 

! o 
+ — 


1 2 


07 J 


001 




\ / 




\ / 



0 



+ 

1 I 



000 I 000 I 001 i 
■+ 



I 

V 



X-register 2 



+• 



o 1 


7 | 6 | 


7 | 0 | 0 


000 


1 1 
111 | 110 | 


1 i 
111 j 000 | 000 


Tag 


15-bit 


address 


0 


76700 


Tag 


Page No. 


| Offset 


000 


Ill 110 1 


| 11 000 000 


0 


175 


| 300 



\ / 
I 

V 



Page table entry (9 4175 
[c(475) + 175 -> 4176] 



I 

+--- + 

|0|0|0|0|0|0| 

! I I I I I I 

1 000 I 000 I 000 I 000 I 000 I 000 i 

+---- + 

I Page addr mod 256 | |Act| J 

I I i I I 
j 000 000 000 0 j 00 j 0 I 00000 i 
+ ----_----+ 





Final 


Address 




o 


7 | 6 


| 7 | 0 


1 
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FNP Address Calculation Example 3 
Reference To Address In Extended Memory 



c (x2)=-076700; c(x3)=077240 ; c(475)=004000; c(4175)=000000 ; c(4176)=133040 



+ --------- --_.---_---_--+ 

| Instruction: Ida 1,3 j 

+--.__>..__-_-__----_.«,--_---___--._+ 

|3|0|7|0|0|1| 

I I I I I I I 

| Oil | 000 I 111 I 000 I 000 j 001 i 
+ -_-_---__---__---_-+ 

I I (Tag | Opcode | Delta | 

! ! ! ! ! 

| 0 | 11 | 000111 I 000000001 i 



I 0 I 3 I 

+ 

\ / 



07 



001 

\ / 



X- register 3 



o 1 


7 I 7 | 


2 | 4 | 0 


000 


1 1 
111 | 111 | 


1 1 

010 j 100 | 000 


Tag 


15-bit 


address 


o ! 


77240 


Tag | 


Page No. 


| Offset 


000 | 


Ill 111 0 


| 10 100 000 


0 1 


176 


! 240 



\ / 

V 



\ / 



Page table entry @ 4176 
[c(475) + 176 -> 4176] 



I 
I 

+ ----- ---- + 

|1|3|3|0|4|0| 

I I I I I I I 
| 001 I 011 I 011 I 000 I 100 I 000 j 
+------------- ----- - — - + 

I Page addr mod 256 | |Act| | 

I III I 

j 001 011 Oil 0 j 00 | 1 | 00000 | 
+_-_-__-. ------- + 

-A /— — - 



+-----_-------..--. - — + 

| Final Address | 
+- - ---------------- - — - .-+ 

"| 1 | 3 | 3 | 2 | 4 | 1 | 

+ ----_------_-------.+ 



| 3 | 3 



2 | 4 
I 

010 | 100 



| 001 i Oil I Oil 

+ - - 

I 001 Oil Oil 0 I 10 100 
+ 



--_--=+ 

I o i 

I I 

I 000 i 
000 I 



/ 
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I HSLA 

I High-Speed Line Adapter 
I Emulated in 6670s 

I All communications lines are connected to HSLAs 
I Maximum of 32 channels per HSLA 

I Maximum of 3 HSLAs per FNP => maximum of 96 channels per FNP 

I HSLAs do much of the work of running a channel, freeing up the FNP's 
CPU 

I Set and detect RS232 signals 

I Interrupt FNP when a signal changes 
I Read incoming characters into a buffer 

I Interrupt FNP when action is required 
I Buffer full 
I BREAK condition 

J Interesting character (such as CR, LF, EOT) read 

I Character Control Table (CCT) tells HSLA what characters 
are interesting 

I Does not do echoing 

I Send buffer of characters to terminal 
I Interrupt FNP when finished 
I Old FNPs had HSLAs and LSLAs (Low- Speed Line Adapters) 
I Channel names 

I One component for each level of multiplexing 
I FNP. H/L 99 

I b.hlOl 
I FNP . H/L 99 . SUB 
I a.h006.prtl 
I Mother/Daughter Boards 
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I 



HSLAs are emulated by Mother and Daughter Boards 



I 



Communications lines are connected to daughter boards 



1 




I There are different types of daughter boards for different types 
of lines 

I Asynchronous 



! BSC 
I G115 

I HDLC X.2< Cc»v^O^C>k> or\\-f \ cU^^V {Wrd 
I HDLC daughter boards only have one line connected instead of two 
1 Daughter boards are properly known as CLAs 

} Communications Line Adapter 
I Daughter boards are mounted on mother boards 

I Four daughter boards can be mounted on one mother board 
I Maximum combined speed of lines on mother board is 72KB 
I An FNP can have up to 16 mother boards 

I 12 mother boards 4 daughter boards 2 lines => 96 lines per FNP 
I 4 mother boards are the equivalent of an HSLA (32 lines) 
I Mother boards are properly known as HMLCs 



I Autocall channels 





O C ell CuT 



I High-speed multi-line controller 
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Mother/Daughter Boards 



|a.h231 a.h230| |a.h229 a.h228| |a.h227 a.h226| |a.h225 a.h224| 

| CIA | | CLA || CIA || CIA | 

I Oaq^-w M I !_! !_! !. 

| HMLC M&TAer @>fi*rj 



|a.hl07 a.h!06| |a.hl05 a.hl04| |a.hl03 a.hl02| |a.h!01 a.hl00| 
| CIA || CIA || CIA || CIA | 
J l_l l_J I. 

1 

| HMLC 

I 



|a.h031 a.h030| |a.h029 a.h028| |a.h027 a.h026| |a.h025 a.h024| 
| CIA || CIA || CIA || CIA | 
I l_l l_l l_J I. 

HMLC 



|a.h023 a.h022| |a.h021 a.h020| |a.h019 a.h018| |a.h017 a.h016| 
| CIA | | CIA | | CIA | | CIA | 

.1 l_l _!_J l_! L 

! 

HMLC | 
I 



h015 a.h014| |a.h013 a.h012| |a.h011 a.h010| |a.h009 a.h008| 
CIA || CIA || CIA || CIA | 
l_l l_! l_l I 

HMLC 



|a.h007 a.h006| ja.hOOS a.h004| |a.h003 a.h002| |a.h001 a.hOOOj 
| CIA || CIA j| CLA |j CIA | 
I l_l l_l l_l I. 

HMLC 



o HMLC = Mother Board 
o CIA = Daughter Board 



MCS Overview 



FNP Hardware Description 



F86 Page 1-41 



I DIA 

I Direct Interface Adapter 
J Connects Multics IOM to FN? IOM 
I 200KBit/sec smart controller 
I DIA can: 

I Send interrupts in both directions 

I Transfer data between memories of FNP and Multics at request of 
either 

I MCS does not use all these possibilities, i.e. FNP initiates all data 
transfers 

I Can have 2 DIAs per FNP 

I But Multics will view each DIA as a separate FNP 
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h MCS Manuals 

I AN85: Communication System SDN 

I MCS Internals, both Ring 0 and FNP 
I Theoretically unavailable: last update MR7.0 
I CC75: Multics Administrators' Manual --.Communications 
I AG93: Multics Subroutines and Input/Output Modules 
I AG91: Multics Programmer's Reference Guide 
I TTF described in Appendix B 

I Input conversion rules explained in Chapter 3 
I AN87: Hardware and Software Formats PLM 

I Theoretically obsolete and unavailable 

I Chapter 6 has FNP data formats 
I DD01: DN355/6600 Macro Assembler Program 
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a CMF/CDT 

I Channel Definition Table 

I GDT describes all configured FNPs, multiplexers, lines 
I Created from ASCII source file Channel Master File 
J An Answering Service Database 
I Stored in >scl>cdt 

I Used by Initializer to manage lines, logins, etc. 

I Used to initialize Ring 0 databases at Multics bootload 

I Ring 0 Databases are not stored permanently 
I Used to initialize FNP databases at FNP bootload 
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Sample CMF 



Sp ar e_channe l_count 
FNP_r e qui r e d_up_t ime 

Check_acs : all ; 

a; 



v^.^^ "Kua\l 0 jt o-v^^Clov-w^ 



10- ^° a ^ CU(KWA t (l5 

; : 5;' ^ - - jwT J 



FNP: 
type: 
lsla: 
hsla: 
memory : 
image : 
service 

name: 
baud: 



H»<MO U-\>0 \ 'O \U^«M V.<ei»CV WO\ m'tw ^ 



3; 
64; 

>s ldd>mc s>inf o>f np_a ; 
active ; 



a.cOOO; 
9600; 
service: slave; 



name: 
baud: 

service: mc; 



a.hOOO; 
1200; 



name: a.hOOl; 

baud: 1200; 

service: login; 

name: a.h002; 

baud: 1200; 

service: login; 



name : 
baud: 



a.h003; 
1200; 



comment: "COLTS executive channel"; 
line_type: COLTS; terminal_type : none; 



comment: "console pupitre" ; 

line_type: ASCII; terminal_type : ROSY; 

attributes : hardwired , dont_read_answerback ; 

comment: "console datanet" ; 

line_type: ASCII; terminal_type : ROSY; 

attributes : hardwired , dont_read_answerback ; 

comment: "AJ510 dans salle de consoles 125"; 
line_type: ASCII; terminal_type : AJ510; 
attributes : hardwired , dont_read_answerback ; 

comment: "AJ860 dans salle de consoles 121"; 
line_type: ASCII; terminal_type : AJ860; 
attributes: hardwired, dont read answerback; 



service: login; 

/*** a.h006 is X.25 Sync HDLC daughter. This board steals a.h007 as well. */ 



name: a.h006; 
comment : 
service : 

multiplexer_type : 
baud: 

terminal_type : 
line_type: 



"X.25 canal principal 113001300"; 

multiplexer; 

x25; 

9600; 

X25_TRANSPAC ; 
X25LAP; 



name: a.h006 . d01-a.h006 . d02 ; 

service : autocall ; 

generic_destination: "transpac" ; 
comment: "X.25 dial_out sub - channel " ; 

name: a.h006 . 001-a.h006 . 013 ; 

service: login; 

comment: "X.25 login sub-channel"; 

terminal_type : ascii_crt; 
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baud: 

attributes : 



1200; 

dont read answerback; 



name: a.h008; comment: "connexion stations HASP"; 

baud: 4800; line_type: BSC; terminal_type : HASP_H0ST; 

multiplexer_type : hasp; 

service: multiplexer; attributes: A hardwired; 



name: 
baud: 
service: 



name: a.h008.opr; 
service: 
line_type : 
terminal_type : 

name: a.h008.rdrl; 
service: 
■ line_type: 
terminal_type : 

name: a.h008.prtl; 
service : 
line_type : 
terminal_type : 



slave; 
BSC; 

HASP_H0ST; 



slave; 
BSC; 

HASP_H0ST; 



slave; 
BSC; 

HASP_HOST; 



name : a . h008 . punl ; 

service: slave; 

line_type: BSC; 

terminal_type : HASP_HOST ; 

a„h010; comment: "Questar dans le bureau Adjemian- Weber" ; 
4800; line_type: ASCII; terminal_type : VIP7205; 

login ; attributes : hardwired , dont_read_answerback ; 
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I 



CMF delivered in >udd>sa>a 



I 



FNP_required_up_time : 



f ni _1 1 1 j 

1 biooai K,eywoi.u 



I 2 crashes in this time => no reload 
I Applies to lower -level multiplexers as well 
I Spare_channel_count: 
I Global keyword 

I Number of extra entries in ring 0 databases 

I Adding CDT entries for which there is no room in ring 0 databases 
causes problems 

I Other global keywords 

I Define default values for omitted local keywords 

I FNP: 

I One FNP statement for each configured FNP 
I Followed by information about the FNP 
I type: 

I dn6670 0«*e^c f° r 
I memory: 

I Memory size in Kwords 
I hsla: 

J Number of HSLAs: can always say 3 

I Must have one line declared on HSLA 0 before using HSLA 1 
I Likewise for HSLA 1 and 2 
I image: 

I Pathname of image to load in FNP 
I service: 

I active or inactive 
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I name : 

I One name statement for each configured channel 
I Followed by information about the channel 

I Can have a range of channel names, e.g. a.h006 . 001-a.h006 . 016 
{ comment : 

I Comment stored in CDT 

I Not like /* comments */ which are ignored in GMF 
I Important to use comments to document 
I Also important to have well -organized CMF 
I baud: 

I Up to 19.2KB for async, 72KB for sync 

I 110, 133, 140, 300, 600, 1200, 1800, 2400, 4800, 7200, 9600, 
19200, 40800, 50000, or 72000 

I line_type: 

I Line protocol: ASCII, G115, BSC, VIP, ?0LLED_VIP, or X25LAP 
I Cannot be changed by user 
J service: 

I login 

I Loaned to process for duration of process 
I Initializer owns all lines 
I slave 

I Loaned to existing process , returned when finished or at 
end of process 

I Requested by sending wakeup to Initializer (using 
dial_manager_) 

I Example: Used by I/O daemons to attach printers, readers, 

I mc 

I Like slave, but for the Initializer's own use 
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I Used for operator terminals 



I 



autocall 



I Like slave, but Initialize!, wakes j-equested phone or 
network connection before loaning it 




I inactive 

I Not listened to when FNP boots 

I Useful for holding a spot for a line that is not yet 
physically installed 

I multiplexer 

I Line is a multiplexer channel 

I multiplexer_type statement must be used as well 
I mul tip lexer_ type ; 



I dataset_type : 

I Used mostly for half- duplex modems 

J Require special handling of RTS , CTS , etc. 
I terminal_type : 

I Can be changed dynamically by user 

I For multiplexer, TTF entry gives multiplexer- specif ic parameters 
in the additional_info field 

I generic_destination: 

I Valid for autocall and slave lines 

J Allows users to attach line without knowing channel names 

I Useful to group together channels , allow changing channel 
assignments without affecting users 

I charge : 

\ Specifies a surcharge for using the channel 

I For login lines this is in addition to connect charges 



J ibm3270, vip7760, hasp, x25, or sty 
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I Must correspond to device type in installation parms 
I check_acs : 

I ACS Segments in >scl>rcp 

I E.g. >scl>rcp>a.h001.acs n 0 // 4ccsj£ >f. £xsP«p"<s^ 
I Keywords specify when access checking is to be done 

I login 

I slave 

I priv_attach 

I dial_in 

I dial_out 

I all 

I Default is priv_attach, dial_out 
I attributes : 

I hardwired 

I Eliminates use of the login_time parameter in 
installation_parms 

I set__modes 

I Modes are set according to default terminal type at dialup 

I Only attribute that is on by default 

I dont_read_answerback 

\ System does not send A E (ENQ) at dialup to request 
terminal ' s answerback 

I check_answerback 

J See answerback statement 

I audit 

I See access_class statement 
I none 

I A audit , A check_answerback , A dont_read_answerback } "hardwired 
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I Default is 

set_mod.es , A audit , A check_answerback, A dont_read_answerback , A hardwired 
I answerback : 

I Specifies expected answerback for terminal 

I If check_answerback attribute is set, any other answerback will 
be refused connection 

I access_class : 

I Specifies the AIM classes of users allowed to login on the line 

I Enforced if the audit attribute is set Gl^^TxOa cx^A ^ 

I ini t i al_c ommand : 

I Preaccess command (e.g. login, modes, ttp, etc.) to be executed 
at each dialup 

I cv_cmf 

I Converts CMF into CDT 

I Usually CMF.cmf -> CMF.cdt 

I Resulting segment has same format as >scl>cdt but with no dynamic 
information 

I install 

I Initializer is the maintainer of CDT 
I Sends a request to Initializer 

I Initializer merges dynamic info from existing CDT with info from new 
CDT 

I Requires access to >scl>admin_acs>cdt. install . acs 
I Adding, deleting, changing channels 

I Many CMF changes do not take affect immediately 
I Some require FNP reboot to take affect 

I Tables 5-1 and 5-2 in CC75 explain when changes take effect 
I Most important are adding lines and changing speed of lines 
I Require FNP reboot 
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I Two commands for displaying information from CDT 
I display_cdt 

I Gives detailed information on CDT entries 
I tty_lines 

I Gives brief information on CDT entries 
I reset_cdt_meters resets n_dialups, n_logins, dialed_up_time 




r 
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display_cdt 



CDTE at 515 | 15360 

in_use : 

name: 

comment i 

charge_type : 

service_type : 

current_service_type : 

dim: 

line_type : 
terminal_type : 
baud_rate : 
fnp_no : 

flags . attributes : 

event : 

tra_vec : 

count : 

twx: 

state: 

current_terminal_type : 
cur_line_type : 
tty_id_code : 
process : 
next_channel : 
n__dialups : 
n_logins : 
dialed_up_time : 
dialup_time : 
recent_wakeup_count : 
recent_wakeup_time : 



J V. ClJ.CtJ.CU. J 

a,hll4 

DKU7102 sur sous canal mpx trt de Paris2 

0 (none) 

1 (login) 
1 (login) 
1 (tty) 

1 (ASCII) 
DKU7102 
1200 
1 (a) 

hardwired, dont_read_answerback, check_acs ; 

000470001164407777000107 

3 (wait_login_line) 

1 

46 

5 (dialed up) 

MS 10 

1 (ASCII) 

none 

77777 | 1 

0 

393 
348 

1083 hrs 45 mins 11 sees. 
02/20/84 1727.4 hfh Mon 
1 

02/20/84 1807.9 hfh Mon 
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Values for tra_vec in display_cdt output 
and WP column in tty_lines output 



wait 
wait 
wait 
wait 
wait 
wait 
wait 

8 wait 

9 wait 

10 wait 

11 wait 

12 wait 

13 wait 

14 wait 

15 wait 

16 wait 

17 wait 

18 wait 

19 wait 

20 wait 

21 wait' 

22 wait 

23 wait 

24 wait 

25 wait 



dialup 
_answerback 
_login_line 
_login_args 
_old_pas sword 

password 
_new_pas sword 
_logout_sig 
JLogout 
_logout_hold 

detach 
_new_proc 

remove 

_f in_priv_attach 
_dial_release 
_dial_out 
hangup 

_slave_request 
_gr e e t ing_ms g 
_de 1 e t e_channe 1 
_c onne c t_r e que s t 
_tandd_hangup 
f in_tandd_attach 
_di s c ar d_wakeup s 
_b e f o r e_hangup 



Channel waiting for dialup. 
WRU sent, waiting for reply- 
Greeting typed, wait for login command. 
Want rest of login line 

"-cpw" was specified. Wait for old password. 

Waiting for password. (If "-cpw", repeat of new one.) 

"-cpw" was specified. Wait for new password 

Channel is hooked up. Wait for logout. 

A logout has been requested. Wait for process to die 

As above but don't hang up when it dies. 

As above but ignore channel afterwards. 

As above but make new process and continue . 

As above but completely expunge channel. 

When channel dials up, connect it to user 

Waiting for master process to release. 

Waiting for auto call to complete 

Wait for the hangup event to occur for a channel 

Ignore line until someone asks 

Print greeting message and wait for login line 

Channel deleted - mark cdte after process is destroyed 

logged in; awaiting request re disconnected processes 

when channel hangs up, proceed with t & d attachment 

when channel dials up, finish t & d attachment 

disregard all wakeups on channel 

allow output to print before hanging up 



1 masked 

1 hung 

2 known 
5 dialed 



Values for state in display_cdt output 
and S column in tty_lines output 

Terminal channel is there, but masked by MCS 
Terminal channel is there, but dead. 
Channel being "listened" to, awaiting dialup 
Channel is dialed up. This is normal state. 



Values for in_use in dispiay_cdt output 
and A column in tty_lines output 



0 


free 


Entry 


is empty . 


1 hung up 


Entry 


is usable but tty is hung up. 


2 


listening 


Entry 


is waiting for phone call. 


3 


dialed 


Entry 


is connected but login not complete 


4 


logged in 


Entry- 


is logged in but no process. 


5 


logged in & proc 


Entry 


has a valid process. 


6 


dialing 


Entry 


(auto_call line) is dialing 


7 


dialed out 


Entry 


(auto_call line) is in use 
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tty_lines 



Attached lines - 132 (size - 136) at 02/20/84 1817.0 



vr 




TStt-.O 

xjrpe 




L*SJ . 


c 


T.TD 
V» J. 


A 


12 

uauu 




8L . CUUU 




/nth 




A 
U 




1 8 

xo 


o 
c. 




uUtilQ cXcCUUlvc CiiaXlXlc X 


a "hnnn 

a . ilUUU 








u 


-> 


A 

u 


1 

X 


liUU 


console pup xuxe 


o . UvU X 








1 9S 






"5 


1 900 




a h002 




AJ510 




171 






•J 


1 900 


A T S1 n H at! c eal 1 a do pnrtcnl o e 1 9 S 


a V|003 
a. « UUVJ 




A,] 860 




J — ) J 


«; 
j 


1 7 
x / 


1 

X 




A TftAfi /^flnc col 1 o Ho ^ft*ncft1 o o 191 
ftjoou uo-iio adiic uc Luuaui.cs xz.x 


a h006 

CI. . kk\J\J\J 




(NU) 






0 




1 

X 


1 900 

Xi, VJVJ 


V 9R Tllfl 1 AT />Vl£lYVrM»l 
.A . ilicX | Ui ClidiUIC X 


a Ti006 


dOI 






1 649 
xc+ y 


i 

X 


1 8 
xo 


1 

X 


^00 


V 9S al nut" en"H™r»"ViaTiTiol 


a h006 


d09 






603 


1 

X 


1 8 

xo 


1 

■L 


300 




a h006 


dO^ 






998 


1 

X 


xo 


1 

X 




A.^J Uldl UUL. auu — CllCLlllUS X 


a.h006 


.d04 






89 


1 


18 


1 


300 


X.25 dial out sub -channel 


a.h006 


.d05 






38 


1 


18 


1 


300 


X.25 dial_out sub -channel 


a.h006 


.001 


ASCII 


CAPS 


2788 


5 


8 


5 


1200 


Desgoutte CNIP2 (none) X.25 login sub-channel 


a.h006 


.002 


MINITEL 


1790 


2 


1 


2 


1200 


X.25 login sub -channel 


a.h006 


.003 


ASCII_ 


CRT 


1441 


2 


1 


2 


1200 


X.25 login sub -channel 


a.h006 


.004 


ASCII" 


~CRT 


1144 


2 


1 


2 


1200 


X.25 login sub -channel 


a„h006 


.005 


ASCII" 


CRT 


910 


2 


1 


2 


1200 


X.25 login sub -channel 


a.h006 


.006 


ASCII" 


CRT 


719 


2 


1 


2 


1200 


X.25 login sub -channel 


a.h006 


.007 


ASCII" 


°CRT 


587 


2 


1 


2 


1200 


X.25 login sub-channel 



tty_lines display_cdt 

field field 

Name name : 

Type current_terminal_type : 

No . n_dialups : 

S state : 

WP tra_vec : 

A injj.se : 

Baud baud: 

User comment: 
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a FNP Images 

I An FNP image is the software to load into the FNP 

I It consists of 'object decks' of individual programs bound together by the 
bind_fnp command 

I Two FNP images are delivered in system libraries 

I >unb>mcs 

J >unb>site_mcs 

I When the FNP is booted (during Multics bootload or by operator command or 
after FNP crash) this software is sent to the FNP from Multics 

I Before loading, configuration information from the CDT is patched in 

I An FNP's image must contain all software necessary to run the types of 
lines configured on the FNP 

I An image should not have unneeded software 

I This would waste FNP memory that could be used for I/O buffers 
J Choosing the necessary modules is the main work in creating an image 

J All software must fit in <32K 

I The site_mcs and mcs images contain software for several types of lines 

I Sites create their own FNP images tailored to their FNP line- 
configurations 

I Often have a different image for each FNP 

1 Image is stored in a segment whose pathname is specified in CDT 
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FNP MODULES 



Module Name 



Needed if: 



Which should happen: 



Qia_ian 

interpreter 

scheduler 

utilities 

init 

control_tables 
hsla_man 

trace 

meters 

melt 

g!15_tables 

bsc_tables 

x2,5_ tables 

hasp_tables 

vip_tables 

polled_vip_tables 

-ibm3270_tables 

acu_tables 

aut ob aud_t ab 1 e s 

ic_s ampler 

br eakpo int_man 

console man 



always 
always 
always 
always 
always 

line_type : ascii ; 
hsla: >0; 

module : trace ; 
meter : yes ; 
line_type: COLTS 

line_type : gll5 
1 ine_type : b s c ; 
line_type: x2 5 lap ; 
multiplexer_type : hasp 
line_type : vip 
line__type : polled_vip 
line_type: bsc; + ibm3270_ 
service : autocall ; 
baud: auto; 

debug_fnp ic_ sample 
debug_fnp breakpoints 
console : yes ; 



_ t - 

a x. w a.y » 



always 
always 

a^ays j ^ 

always 

alwa y s , ^ *JG US 

usually Slows «* f^<* 
usually x 
usually ^ V ^ 



sometimes 
sometimes 
sometimes 
sometimes 
sometimes 
sometimes 
sometimes 
sometimes 
sometimes 

rare 
rare 
rare 



(Level -6 remotes) 
(HASP, IBM remotes) 
(real Multics x.25) 
(HASP) 
(Sync VIPs) 
(Polled sync VIPs) 
(3270 controller) 
(non-x.25 dialout) 
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I The bind_fnp command uses a control file with .bind_fnp suffix to select 
software modules to put in FNP image 
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/* bindfile for MCS, Multics Communications System */ 
version: 6.5d; 



H c.«W-J ^° <=iT, <nW- S < Now,, ^^4. 



Isla: 0; 
hsla: 

memory : 64 

console : no 

printer : no 

meter : yes ; 

/* module load list - init module must be last */ 

order: scheduler, 

interpreter , 
control_tables , 
dia_man , 
melt, 
hsla_man, 
utilities , 
trace , 
bsc_tables , 
hasp_tables , 
x25_tables , 
meters , 
init; 

/* entry to init from bootload */ 

entry: is tart; 

/* table size specifications */ 



module : 
type: 
size: 




module : trace ; 

type : trace ; 

mask: 317777; 

size: 2048; 



end; 



/* trace enable mask */ ^ ' o"v^ 

/* mask bits: 0 scheduler 

1 dia_man 

2 interpreter 

3 utilities 

4 lsla_man 

5 hsla_man */ 
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bind_fnp 



f np_a . b ind_f np [ wd ] >* . ob j dk 

i I 
V V 

I ~ ~~~ " I 
| bind_fnp fnp_a | 



V 

fnp_a 



f np_a . bind_f np ( [ contents [wd j >f np_a . search] ) >* . ob j dk 

! I 

V V 

I ^ " ~ I 

j bind_fnp fnp_a -dr -list | 



V V 
f np_a f np_a .list 
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LDD Structure 



+= 



Idd 
-+--- 

I 

mcs 
-+= - = 



--+ 

I 

I 

--+ 



+-------+-----■ 

| source 

i 
I 

* . s . archive 



| object | 

+---- — 

I 
I 

* . archive 



+-------+------+ 

| info | 

+- --+------+ 



355_macros 
macros .map355 
macro s_asm 
site_mcs . b ind_f np 
site_mcs . list 
mcs ,bind_fnp 
mcs . list 
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SLDD Structure 



+ + 

| sldd | 

+ + + 

I 

+ . + _+ 

1 mcs | 
+ +-- + 

I 

+ + + 

I I I 



source 



-+ 



+-- 

! 

+-- 



— + + 

object | 
• — +--- + 



info 
.__+__. 



+ 



-+ 



*.s.ud. archive 



* . ob j dk 



f np_a . b ind_f np 
fnp_a. list 
fnp_a. search 
f np_b . bind_f np 
fnp_b . list 
fnp_b . search 

355_macros 
macros .map355 
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I map355 

I The assembler for MAP355, the assembler language of the FNP 
I actually cans uouo euiuiauui uu tciii assciuuici 

I GCOS software is necessary 
I toto.map355 -> toto.objdk 
I -list control argument 
I -macro_file control argument 

I Default is -macro_file >ldd>mcs>info>355_macros 
I macros 

I Like include files for PL/I 

I gcos >ldd>mcs>info>macros_asm -truncate {-list -lower_case} . 
I macros .map355 -> 355_macros 
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a Attributes in SAT/PDT 



I save_on_dis connect 
I disconnect ok 



Attributes in SAT/PDT 
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h Conf ig deck 

I PRPH FNP A A 18. ON 
I PARM TTYB 10240. 
I Default - 6K 
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a installation_parms 
I cwe_count 

I Initializer hangs up login line if more than cwe_count wakeups in 
cwe_time seconds 

I Default 10 
I cwe_time 

I Default 3 seconds 
I login_time 

I Initializer hangs up login line if no login in login_time seconds 
I Typical value 180 seconds 

I Not used for lines marked attibutes : hardwired 
I device_prices , device_names 

I Used in conjuction with charge_type: in CDT 
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a Operator commands 
I load_mpx 

j Start FNF or lower -level multiplexer 

I Starting FNP means loading it with image 
I Then load lower- level multiplexers 

I And start listening to all non- multiplexed lines that are 
not service: inactive 

T Starting lower- level multiplexer is similar to listening to a 
non -multiplexed lines 

I Accept connection, and when connection is made initiate 
protocol 

I Done automatically during Multics bootload (during Answering Service 
startup) and after multiplexer crash 

I Done manually with load_mpx to change some line attrs , add lines 

I Any lines already in use must be hung up before reloading multiplexer 

I Use -force to force hangups 

I dump_mpx 

I Stops multiplexer completely 

I If it is an FNP, a dump is taken 

I stop_mpx 

I Stops further dialups from being accepted by multiplexer 

I Used when an FNP with logged in users must be reloaded 
I stop_mpx 

I send_message or warn or bump fnp 
I load_mpx 

I Prevents automatic loading if done before Answering Service startup 
I start_mpx 

I Undoes the effect of stop_mpx 
I bump fnp tag 
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I Allows bumping of users on a single FNP 
I detach 

I Makes a line inactive, bumping any user connected on the line 
I remove 

I Like detach, but uses a more brutal method of terminating user's 
process 

I attach 

I Makes a line active, undoing the effect of detach or remove 
I Gan also recover masked channels 
I accept 

I Accepts the line as an operator terminal 

I Line must be service: mc, or can type 'dial system' on a login 
terminal 

I drop 

I Undoes the affect of an accept 
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Advanced MCS User Features 



a Terminal Characteristics 

I Many terminal characteristics can be modified 
I Character set/code 

I Character sequences to move carriage/cursor 
I Use of tabs 
I Padding 

I Terminal initialization (set tabs, etc.) 
I Line/page length 
I Character echoing modes 
i These characteristics can all be modified several different ways 
I TTF 
I stty 

I io_call control, io_call modes 

I iox_$control , iox_$modes 

I We will look at how to modify them in per terminal - type in TTF and 
dynamically using iox_ 

I stty and io_call are just command- level interfaces to iox_ 
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a TTF/TTT 

I ASCII source Terminal Type File is used to produce Terminal Type Table 

I Has three major types of information 

I Characteristics of different terminal types for use by Ring 0 and FNP 

I Characteristics of different terminal types for use by the Video 
System 

I Definition of some preaccess commands 

I Definition of terminal answerbacks 
I System TTT is in >scl>ttt £ £* 

I cv_ttf 

I Converts TTF to TTT 

I Usually TTF. ttf -> TTF.ttt 

I install 

I The install command is used to install new TTT in >scl>ttt 
I Unlike CMF, there is no dynamic information 

I Process calling the install command does the installation itself 
I >scl>ttt is protected by ring brackets of 1,5 ,5 
I Access required to >scl>admin_acs>ttt. install. acs 
I Can use private TTTs 
I set_ttt_path 

1 Specifies the TTT to use in process 

I Preaccess command and answerbacks not meaningful in private TTT, 
since they are only handled by Initializer 

I display_ttt 

I Used to display some or all of a TTT 

I TTF Syntax 

I TTF is a typical source file for a table with statements Identified 
by keywords 



Advanced MCS User Features 



TTF/TTT 



F86 Page 3-2 



I Many statements take characters or lists of characters as arguments 
I Such characters may be specified in several different ways 

I Single unquoted character, e.g. X 

I Single quoted character, e.g. "X" or ■ ; " 

J 1 to 3 digit octal number, e.g. 033 

1 Control character name, e.g. ESC 

I Control characters in form A A 
I Repetition of single characters or groups of characters is possible 

I Uses (N) for repetition factor 

I < ... > to group characters 
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Terminal Type Definition 



Input_convers ion : s tandar d_input_conv ; 

/***** Typical ASCII teleprinter terminal *****/ 
terminal_type : ASCII; 
modes : default , 1179 , A pl , c an_type=overstr ike ,hndl quit , 
fulldpx, echoplex , crecho , If echo , A tabs , tabecho ; 



bauds : 


110 


133 




150 




300 




600 




1200 




vert_nl_delays : 


0 


1 




1 




5 




9 




18 




horz_nl_delays : 


0.00 


0 


012 


0. 


025 


0. 


019 


0. 


060 


0 


120 


c ons t_t ab_de 1 ay s : 


0 


0 




0 




0 




2 




3 




var_tab_delays : 


0 


0 


180 


0 


250 


0. 


250 


0. 


500 


1 


000 


backspace_delays : 


0 


0 




0 




0 




1 




2 




vt_f f_delays : 


9 


24 




29 




59 




100 




200 





output_conver s ion : asc i i_output_conv ; 
special: ascii_special ; 
line_types: ASCII, VIP, POLLED_VIP; 
old_type : 11 ; 

/***** ASCII teleprinter terminal (upper-case only) *****/ 
terminal_type : ASCII_CAPS like ASCII; 

modes : default , 1179 , A pl , can_type=overstrike , hndlquit , capo , 
fulldpx, echoplex, crecho , If echo , A tabs , tabecho ; 

special: ascii_caps_special; 

input_translation: ascii_caps_input_trans ; 

old_type: 7; 

Typical ASCII crt terminal *****/ 
terminal_type : ASCII_CRT like ASCII; 
modes : default , 1179 , pl23 , can_type=replace , hndlquit , scroll , 

fulldpx , echoplex , crecho , If echo , A tabs , tabecho ; 
bauds: 110 133 150 300 600 1200 

/***** ASCII CRT terminal (upper-case only) *****/ 
terminal_type : ASCII_CRT_CAPS like ASCII_CAPS ; 

modes : default , 1179 , pl23 , can_type=replace .hndlquit , scroll , capo , 
fulldpx , echoplex , crecho , If echo , A tabs , tabecho ; 

bauds: 110 133 150 300 600 1200 

/***** TeleVideo, Inc. Model TVI-912 *****/ 
terminal_type : TVI912 like ASCII_CRT; 

modes : default , 1179 , pl23 , can_type=replace , hndlquit , scroll , 
fulldpx , echoplex , crecho , If echo , tabs , A tabecho ; 

initial_string: ESC 3 CR ESC 1 (7) <(10) <SP> ESC 1> CR; 

special : tvi912_tvi92Q_special ; 
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& tty_ Modes and Control Orders 

I Look at many functions of Ring Zero and FNP by looking at user interface 

j The tty_ I/O module and asynchronous lines are used as examples 

I Much processing is the same for non-multiplexed synchronous lines, and for 
subchannels of multiplexers 

I Comparison with other line types is made whenever possible 

I Terminal Initialization 

I Initial string specified in TTT 

I Sent to terminal at dialup time 

I Generally used to set tabs 

I Can be resent using send_initial_string control order 

J Only useful for asynchronous terminals 

I Input Conversion, Translation, etc. 

I All terminal input goes through four steps of conversion and 
translation 

I Translate to ASCII ^ N** 1 

I Put in canonical form ^S^c- v "V*^ ^ ^ 
I Process erase and kill characters 
I Process input escape sequences 
I All of these steps are performed in ring 0 

I All of these steps are exactly the same for all line types: 

asynchronous lines, non-multiplexed synchronous lines, multiplexer 
subchannels 

I Translation v<- oW-tc So ft*. Vfc*> 8^ <W"> (U«* ^ 

I Input is translated into ASCII 
I Similar to PL/I translate built in 

I Does not change size of input string 
I Does not change what is echoed to terminal 

I Echoing is done in FNP, translation is done later in Ring 0 
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I ctl_char mode 

I When a terminal is in ctl_char mode, control characters are 
accepted as input 

I Otherwise control characters are discarded 

I If terminal is not in ctl_char mode, a second translation 
is done to translate all control characters into NULs 

I NULs are normally discarded later in the input 
translation/conversion process 
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Input Translation 
Extract From Terminal Type File 



terminal_type : 



input_tr ans lat ion : as c i i_cap s_input_ trans ; 



translation_table : ascii 
000 001 002 003 004 005" 
010 Oil 012 013 014 015 
020 021 022 023 024 025 
030 031 032 033 034 035 
040 041 042 043 044 045 
050 051 052 053 054 055 
060 061 062 063 064 065 
070 071 072 073 074 075 
100 141 142 143 144 145 
150 151 152 153 154 155 
160 161 162 163 164 165 
170 171 172 133 134 135 
140 141 142 143 144 145 
150 151 152 153 154 155 
160 161 162 163 164 165 
170 171 172 173 174 175 



caps_input_trans ; 
006 007 /*NUL SOH 
016 017 /*BS TAB 
026 027 /*DLE DG1 
036 037 /*CAN EM 
046 047 /*SP ! 
056 057 /*( ) 
066 067 /*0 1 
076 077 /*8 9 
146 147 /*<§ A 
156 157 /*H I 
166 167 /*P Q 
136 137 /*X Y 
146 147 /*' a 
156 157 /*h i 
166 167 /*p q 
176 177;/*x y 



To 

SIX ETX 
LF VT 
DC2 DC 3 
SUB ESC 
# 



EOT ENQ 
FF CR 
DC4 NAK 
FS GS 
$ % 



cUm^ 



ACK BEL (000- 
SO SI (010- 
SYN ETB (020- 
RS US (030- 
& 



4 
< 
D 
L 
T 

\ 
d 
1 
t 



E 
M 
U 
] 

e 
m 
u 



6 
> 
F 
N 
V 

A 
f 

n 
v 



/ 
7 
? 

G 
0 
W 



o 

w 



(040- 
(050- 
(060- 
(070- 
(100- 
(110- 
(120- 
(130- 
(140- 
(150- 
(160- 



| } - DEL (170- 



007)*/ 
017)*/ 
027)*/ 
037)*/ 
047)*/ 
057)*/ 
067)*/ 
077)*/ 
107)*/ 
117)*/ 
127)*/ 
137)*/ 
147)*/ 
157)*/ 
167)*/ 
177)*/ 



Extract from tty_convert . incl „ pll 
Used for get_input_translation and set_input_translation control orders 

del CV_TRANS_VERS ION fixed bin int static options (constant) init (2) ; 

del 1 cv_trans_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 cv_trans like cv_trans ; 

del 1 cv_trans based aligned, 

2 value (0:255) fixed bin (8) unal; 
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I Canonicalization u ■»$ w / ^"T v £W>T~ otpfrocKck 

I Backspaces present a particular problem on input 

I When we see the string abc in a file we can't know if it was 
originally typed in 

I abc<BSXBSXBS> 

I a<BS>_b<BS>_c<BS>_ 

I Or even ab<BS>_<BSXBS>a<BS> <SPXBSXBS>c 

I Similarly if we see the line abc on a CRT screen it may have 
been typed an infinite number of different ways 

I abd<BS>c, for example 

I Canonicalization tries to apply a what-you-see-is-what-you-get 
rule 

I There are two separate cases, for hardcopy terminals and CRTs 

I can_type=overstrike is for hardcopy terminals 

I If multiple characters are typed in the same column, the 
first characters are overs truck on paper 

I Input is canonicalized to be column by column 

I Multiple characters in same column are put in sorted order, 
separated by backspaces 

I In the example above, canonical form is _<BS>a_<BS>b_<BS>c 

I can_type=replace is for screen terminals 

I If multiple characters are typed in the same column, the 
first characters are replaced on screen 

I Input is canonicalized to be column by column 

I Only the last character in each column is retained, with no 
backspaces 

{ Note that this does not make BS the erase character 
I ab<SPXSPXBS>c and ab<SPXSP>#c give different results 
I can mode 

I Turns canonicalization on or off 
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I Erase and Kill Characters 

I # is normal erase character, @ is normal kill character 
J Any other characters may be substituted 
I erkl mode 

I Turns erase and kill processing on or off 



Erase and Kill Characters 
Extract From Terminal Type File 

terminal_type : ... 

erase: A X; 
kill: A C; 



Extract from tty_editing_chars.incl.pll 
Used for get_editing_chars and set_editing_chars control orders 

del 1 editing_chars aligned based (editing_chars_ptr) , 
2 version fixed bin, 
2 erase char (1) unaligned, 
2 kill char (1) unaligned; 

del editing_chars_version_2 fixed bin internal static init (2) ; 



I Process input escape sequences 

I Each input character is looked up in input conversion table 

I Gets extra processing if marked 

I Break character 

I Used as end of line in get_line calls 

I White space removed in front of break character 

I Doesn't mean that the character will cause line to be 
read immediately 

I Other modes determine when FNP sends line to Multics 

I Discard V P^A C L <>0 
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I Characters thrown away 

I Formfeed 

I Discarded if page length > 0 

I Dates from early days of EOP processing 

I Escape 

I Not to be confused with ASCII ESC (033) 
I Usually backslash character 

I Changes interpretation of following character (s) 
I \<NL> \# \@ \007 \\ 

I Other escape sequences may be defined using input 
conversion table plus special table 

I esc mode 

I Can be turned off to inhibit escape sequence processing 
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Input Conversion 
Extract From Terminal Type File 

terminal_type : ... 



input_conversion : s tandard_input_conv ; 



convers ion_table : s tandard_input_conv ; 



A"3 


a a 
00 


00 


AA 

00 


AA 

00 


Aft 

uu 


AA 

00 


AA 

00 


/* 


NUL SOH STX ETX EOT ENQ ACK BEL 


/AAA AA"7N 
^UUU-UU / ) 


*/ 


00 


00 


01 


00 


04 


00 


00 


00 


/* 


BS 


TAB 


LF 


VT 


FF 


CR 


SO 


SI 


(010-017) 


*/ 


nn 


nn 


nn 


nn 


nn 


nn 


nn 


nn 


/* 


DLE 


nm 




nm 


DC4 


NAK 


SYN 


ETR 


f0?0-027 , > 


*/ 


00 


00 


00 


05 


00 


00 


00 


00 


'/* 


CAN 


EM 


SUB 


ESC 


FS 


GS 


RS 


US 


(030-037) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


SP 


f 




# 


$ 


% 


& 


t 


(040-047) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


( 


) 


* 


+ 


> 






/ 


(050-057) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


0 


1 


2 


3 


4 


5 


6 


7 


(060-067) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


8 


9 




» 


< 




> 


? 


(070-077) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


e 


A 


B 


C 


D 


E 


F 


G 


(100-107) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


H 


I 


J 


K 


L 


M 


N 


0 


(110-117) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


P 


Q 


R 


S 


T 


U 


V 


W 


(120-127) 


*/ 


00 


00 


00 


00 


02 


00 


00 


00 


/* 


X 


Y 


Z 


[ 


\ 


] 


A 




(130-137) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 




a 


b 


c 


d 


e 


f 


S 


(140-147) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


h 


i 


j 


k 


1 


m 


n 


o 


(150-157) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 


P 


q 


r 


s 


t 


u 


V 


w 


(160-167) 


*/ 


00 


00 


00 


00 


00 


00 


00 


03; 


;/* 


X 


y 


z 


{ 


1 


} 




DEL 


(170-177) 


*/ 



Extract from tty_convert . incl . pll 
Used for get_Input_conversion and s e t_inpu t_c onve r s i on control orders 

del CV__TRANS_VERSION fixed bin int static options (constant) init (2); 

del 1 cv_ tr ans_s true aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 cv_trans like cv_trans; 

del 1 cv_trans based aligned, 

2 value (0:255) fixed bin (8) unal; 

del (INPUT_C0NVERT_0RDINARY init (0), 
INPUT_C0NVERT_BREAK init (1), 
INPUT_CONVERT_ESCAPE init (2), 
INPUT_C0NVERT_DISCARD init (3), 
INPUT_C0NVERT_F0RMFEED init (4), 
INPUT_C0NVERT_PRECEDENCE_DI S CARD init (5) 

) fixed bin (8) unaligned internal static options (constant) ; 
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Special Characters Table 
(Only Parts Used In Input Conversion Are Shown Here) 
Extract From Terminal Type File 

terminal_type : ... 

special: ascii_caps_special ; 

special_table : ascii_caps_special ; 
(most of table is used in output conversion) 
input_escapes : /* <escape> <lc-alpha> -> <uc-alpha> (eg: \a -> A) */ 



a" 


"A" , 


"b" 


"B" , 


"c" 


M C", 


"d" 


n D", 


"e" 


11 £11 


f" 


11 F n , 


"g" 


n G n , 


"h" 


"H M , 


ti £ rt 


it j it 


it j it 


tljtt 


k" 


"K" , 


it ^tt 


"L", 


"m" 


"M" , 


"n" 


"N", 


IIqII 


IIQII 


P" 


ttpn 


n q" 


n Q", 




"R", 




"S", 


"t" 


II<ptI 


u" 


"U" , 


«v" 


T, 


» w « 


"W" , 


"x" 


"X", 


tlytt 


nytt 



It rr It II 7 » 



Extract from tty_convert.incl.pll 
(Only Parts Used In Input Conversion Are Shown Here) 
Used for get_special and set_special control orders 

del SPECIAL_VERSION fixed bin int static options (constant) init (1) ; 



del 1 c_chars based aligned, 

2 count fixed bin (8) unaligned, 
2 chars (3) char (1) unaligned; 

del 1 spec ial_chars_s true aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 special_chars , 

(most of table is used in output conversion) 

3 escape_Iength fixed bin, 



3 input_escapes aligned, 

4 len fixed bin (8) unaligned, 

4 str char (sc_input_escape_len refer 

( spec ial_chars_s true . input_escapes . len) ) unaligned , 

3 input_results aligned, 
4 pad bit (9) unaligned, 
4 str char (sc_input_escape_len refer 
( spec ial_ehars_s true . input_escapes . len) ) unaligned; 

del 1 get_special_info_struc based aligned, 
2 area_ptr pointer, 
2 table_ptr pointer; 
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I All of the input translation and conversion steps can be bypassed 

I rawi mode V\P$Q w Q <vC> ~\ l^J w^y 

I Output Conversion, Translation, etc. 

I All terminal output goes through three steps of conversion and 
translation 

I Capitalization 

I Formatting 

I Translation from ASCII 

I All of these steps are performed in ring 0 

I All of these steps are exactly the same for all line types: 

asynchronous lines , non-multiplexed synchronous lines , multiplexer 
subchannels 

I Capitalization 

I capo mode 

I If in capo mode^ t^aa&late all alphabetics to uppercase 
I Formatting 

I 11 mode 

A ll or 11NN, e.g. 1179 
Insert <NL> after NN characters 
I pi mode 

A pl or plNN, e.g. pl23 

Stop with End of Page string after NN lines 

I End of Page string specifiable in special table 
Continue with CR or FF 
CR thrown away if on line by itself 
FF always thrown away if NN > 0 
Originally only FF was accepted 
I scroll mode 
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I Used in conjunction with pi mode 

I scroll intended for scrolling terminals 

I EOP after NN lines of continuous output 

I Line counter reset after user input 
I A scroll intended for non-scrolling screens, e.g. TEK4014 

I Counter not reset, user input adds to counter 

I EOP after NN lines of input or output 
I edited mode 

I In "edited mode, non-printing characters are output as 
octal escapes are printed, e.g. \000 

I In edited mode, non-printing characters are discarded on 
output 

I tab Sm o d e U'."' *< I- J"** 

I In tabs mode, white space is optimized into minimum number 
of tabs and blanks 

I Terminal's tabs must have been set by initial string 

I red mode 

I In red mode, SO (\016 or RRS , produced by ioa_ A R) causes 
terminal to shift to color 

I SI (\017 or BRS, produced by ioa_ A B) changes back to 
normal 

I Used in some system error messages 
J Actually sends sequence from special table 
I On old terminals, shifted to red ribbon 
I On CRTs , can change to - inverse video 
I vertsp mode 

I In vertsp mode, FF and VT are sent to terminal 

I Actually sends sequence from special table 
I In A vertsp mode, FF and VT are sent as octal escapes 
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I Output Conversion 

I Output conversion uses the output_conversion and special 
tables 
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Output Conversion 
Extract From Terminal Type File 



terminal_type : ... 
output_convers ion : ascii_output_conv ; 



conversion_table : ascii_output_conv; 



07 


07 


07 


07 


07 


07 


07 


12 


/* NUL 


SOH 


STX 


ETX 


EOT 


ENQ ACK BEL 


('000-007') 


*/ 


04 


03 


01 


05 


06 


02 


10 


11 


/* BS 


TAB 


LF 


VT 


FF 


CR 


SO 


SI 


(010-017) 


*/ 


07 


07 


07 


07 


07 


07 


07 


07 


/* DLE 


DC1 


DC2 


DC3 


DC4 


NAK 


SYN 


ETB 


(020-027) 


*/ 


07 


07 


07 


07 


07 


07 


07 


07 


/* CAN EM 


SUB 


ESC 


FS 


GS 


RS 


US 


(030-037) 


V 


00 


00 


00 


00 


00 


00 


00 


00 


/* SP 


t 


n 


# 


$ 


% 


& 


t 


(040-047) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* ( 


> 


* 


+ 


> 






/ 


(050-057) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 0 


1 


2 


3 


4 


5 


6 


7 


(060-067) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* 8 


9 




» 


< 




> 


? 


(070-077) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* e 


A 


B 


C 


D 


E 


F 


G 


(100-107) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* H 


I 


J 


K 


L 


M 


N 


0 


(110-117) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* P 


Q 


R 


S 


T 


U 


V 


w 


(120-127) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* X 


Y 


Z 


[ 


\ 


] 


A 




(130-137) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* ' 


a 


b 


c 


d 


e 


f 


s 


(140-147) 


*/ 


00 


00 


00 


00 


00 


00 


00 


00 


/* h 


i 


J 


k 


1 


m 


n 


0 


(150-157) 


V 


00 


00 


00 


00 


00 


00 


00 


00 


/* P 


q 


r 


s 


t 


u 


V 


w 


(160-167) 


*/ 


00 


00 


00 


00 


00 


00 


00 


14;/* x 


y 


z 


{ 


1 


} 




DEL 


(170-177) 


*/ 
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Extract from tty_convert.incl.pll 
Used for get_output_conversion and set_output_conversion control orders 

del CV_TRANS_VERS ION fixed bin int static options (constant) init (2) ; 

del 1 cv_trans_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 cv_trans like cv_trans; 

del 1 cv_trans based aligned, 

2 value (0:255) fixed bin (8) unal; 

del ( OUTPUT_CONVERT_ORDINARY init (0), 
OUTPUT_CONVERT_NEWLINE init (1), 
OUTPUT_CONVERT_CR init (2), 
OUTPUT_CONVERT_HT init (3), 
OUTPUT_CONVERT_BS init (4), 
OUTPUT_CONVERT_VT init (5), 
OUTPUT_CONVERT_FF init (6), 
0UTPUT_C0NVERT_0CTAL init (7), 
0UTPUT_C0NVERT_RRS init (8), 
0UTPUT_C0NVERT_BRS init (9), 
0UTPUT_C0NVERT_N0_M0TI0N init (10), 
0UTPUT_C0NVERT_PRECEDENCE_N0_M0TI0N init (11), 
0UTPUT_C0NVERT_D0NT_S END init (12), 
OUTPUT_CONVERT_FIRST_SPECIAL init (17) 

) fixed bin (8) unaligned internal static options (constant) ; 
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Special Characters Table 
Extract From Terminal Type File 



terminal_type : ... 
special: ascii_caps_special ; 



special_table : ascii_caps_special ; 
new_line: CR LF; 

carriage_return: CR; 
backspace : BS ; 

tab : TAB ; 

vertical tab: VT CR; 



form_feed: FF CR; ^ _^ j ^(t^AX 

pnnter_on: O^ss^J «3 ^ ^ ? tkd 1 

printer_off: ; J %J^»y^s \oc*i Pi^d {n ^ 

red_shif t : ; 

black_shift: ; 

end_of_page: E 0 P; 

input_escapes : /* <escape> <lc-alpha> -> <uc-alpha> (eg: \a -> A) */ 



a" 


"A", 


"b" 


"B" , 


n c it 


"C", 


"d M 


"D", 


"e" 


"E" , 


f" 


"F", 


"g" 


"G" , 




"H", 


it^n 


it j ii 


it ^ it 


"J", 


k" 


"K", 


tt^tt 


"L", 


"m" 


"M" , 


"n" 


"N", 


IIqII 


"0" , 


P" 


"P", 


"q" 


»Q», 




"R" , 


n s" 




"t" 


"T" , 


u" 


"U", 


"v" 


"V" , 


"W" 




"x" 




llyll 


"Y" , 



"Z"; 
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Extract from tty_convert.incl.pll 
Used for get_special and set_special control orders 

del SPECIAL_VERSION fixed bin int static options (constant) init (1) ; 

del 1 c_chars based aligned, 

2 count fixed bin (8) unaligned, 
2 chars (3) char (1) unaligned; 

del 1 spec ial_chars_s true aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 speeial_chars , 

3 nl_seq aligned like c_chars, 

3 cr_seq aligned like c_chars , 

3 bs_seq aligned like c_chars, 

3 tab_seq aligned like c_chars, 

3 vt_seq aligned like e_chars, 

3 ff_seq aligned like c_chars, 

3 printer_on aligned like c__chars, 

3 printer_of f aligned like c_chars , 

3 red_ribbon_shift aligned like c__chars, 

3 black_ribbon_shift aligned like c_chars, 

3 end_of_page aligned like c_chars, 

3 escape_length fixed bin, 

3 not_edited_escapes (sc_escape_len refer 

( spec ial_chars_s true . escape_length) ) like c_chars , 

3 edited_escapes (sc_escape_len refer 

( spec ial_chars_s true . escape_length) ) like c_chars , 

3 input_escapes aligned, 

4 len fixed bin (8) unaligned, 

4 str char (sc_input_escape_len refer 

( spec ial_chars_s true . input_escapes . len) ) unaligned , 

3 input_results aligned, 
4 pad bit (9) unaligned, 
4 str char (sc_input_escape_len refer 
( special_char s_s true . input_es capes . len) ) unaligned; 

del 1 get_special_info_struc based aligned, 
2 area_ptr pointer, 
2 table_ptr pointer; 
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I Translation 

I Translate from ASCII to terminal's character set 
I To bypass all of the above 

I rawo mode 

I All of the above output conversion/translation is done in ring 0 

I Echoing 

I Echoing is done in the FNP 

I Echoing makes sense only for asynchronous terminals 

I Asynchronous terminals connected via X.25 are a special case 

I FNP cannot do echoing, because it does not know about logical 
channels ( « * w^.^ fa* Cc<~* ^ rt "~ ^^'K ><?f^ h«\ 

I Echoing could be done in Ring 0, but would be expensive 

I X.25 has parameters to tell PAD to do echoing 

I fulldpx mode 

I Specifies that line can send and receive at same time 

I Echoing implies fulldpx 

T fulldpx does not imply echoing 

I If A fulldpx, Multics will not send while receiving 
I echoplex mode 

I Each character sent by terminal is echoed back 

I No selection, translation, conversion, etc. possible. 
I If echo mode 

I when CR is received, LF is sent to terminal and placed in input 
stream 

I NL (same as LF) is only true end- of- line character for 
Multics 

I When in A lfecho mode, CRs will appear to be ignored 
J crecho mode 
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I When LF is received, CR is echoed 

I Not allowed for X.25 lines 

i There is no X.25 parameter to have PAD do creche 

I tabecho mode 

I When tab is received, FNP sends back spaces to move 
carriage/cursor to next tab stop 

I Not allowed for X.25 lines 

I There is no X.25 parameter to have PAD do crecho 

I Quit Handling 

I There are a number of steps in handling break condition 

I Handled both in ring 0 and in FNP ^ f'v** K l - 

I True break condition can only occur on asynchronous lines 

J Synchronous protocols such as POLLED_VIP, X.25 have ways to 
achieve similar effect 

I There are two separate controls on this handling 

I Quits are enabled or disabled by control orders 

I quit_enable control order 

I quit_disable control order 

I hndlquit mode 

- I If quite enabled : 

I 1) FNP sends NL, if in hndlquit mode 

I 2) FNP flushes buffers, if in hndlquit mode 

I 3) FNP tells Ring 0 

I 4) Ring 0 flushes buffers, if in hndlquit mode 
I 5) Ring 0 wakes up user process, signalling "quit" condition 
I 6) Ring 4 default quit handler prints "QUIT" 
I For an X.25 line, FNP cannot handle individual logical channel 
I 1) PAD/X.25 network flush buffers, if in hndlquit mode 
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5Ti v 




I 2) PAD/X.25 network tell FNP (via control packet) 



I 3) FNP sends control packet to ring 0 



fie 




I 5) Ring 0 flushes buffers, if in hndlquit mode 

I 6) Ring 0 wakes up user process, signalling "quit" condition 



I 4) Ring 0 sends NL, if in hndlquit mode 



I 7) Ring 4 default quit handler prints "QUIT 



it 



I Polite, Replay 

I Sending output while user is typing can be disruptive 

I Modes exist to make it less disruptive 

I Valid only for asynchronous lines and X.25 subchannels 

I Handled in FNP 

I polite mode 

I If any output occurs while user is typing input line will hold 
output until user finishes input line 

I Timeout after 30 seconds 

I Some X.25 networks have parameter to have PAD handle this 

I prefixnl mode 

I Interrupting output is prefixed with a newline 

I If input line interrupted because A polite, or 30 second 
timeout 

I Not possible for X.25 lines 
I replay mode 

I Replays interrupted input line 



I Non- line -oriented input 

1 Normally the FN? buffers a line of input and then sends entire line 



I If input line interrupted because A poiite, or 30 second 
timeout 



I Not possible for X.25 lines 



to Multics 
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I On the Multics (Ring 0) side, the user process is woken up whenever 
input is sent from FNP to Multics 

I There are ways to change when the FNP forwards data and when a user 



I breakall mode 

1 Causes FNP to forward each character to Multics 

1 User process woken up for each character 

I Necessary or useful for certain applications 

I Input from devices that never send CR or LF 

I dial_out 

I Emacs and Video System 
I Comparatively expensive 



I Echo negotiation is an optimization to make it less expensive 
for Emacs and Video System 

I Typical situation in Emacs/Video is entering text at end of line 

I For each normal character that user types, all that needs to be 
done is echo and store 

I This is almost what FNP does in echoplex mode 

I Additional information needed 

I List of characters that require more than simple echo 
I Number of columns remaining on the current line of the 



I No documented user interface for echo negotiation 

I To use echo negotiation 

I set_echo_break__table control order 

I Input is table of 128 bits in table, telling FNP what 
chars to stop echoing on 

I Then call hcs_$tty_read_echoed 

I Input: buffer_ptr, buffer_size, columns_left 



process is woken up 



I 



Echo 




screen 
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I Output: #characters returned, #characters echoed 
I For X.25 lines, cannot be handled in FNP, nor in PAD 
I Handled in Ring 0 
I wake_tbl mode 

I Changes when user process is woken up 

I Handled in Ring 0 

I Valid for all types of lines 

I Normally woken up for every input 

I Sometimes better to wake up less often 

I Consider qedx input mode 

I qedx has almost nothing to do, and nothing to print, until a \ 
is read 

I wake_tbl specifies that wakeup should be sent only when 
specified characters are in input 

I Table must be set by control order before turning on wake_tbl 
mode 
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Wakeup Table 
Not settable in TTF 



Extract from set_wakeup_table_info.incl.pll 
Used for s e t_wakeup_ t ab 1 e control order 

del swt_info_version_l fixed bin static options (constant) init (1) ; 

del 1 swt_info aligned based (swt_infop) , 
2 version fixed bin, 
2 new_ table like wakeup_ table , 
2 old_table like wakeup_table; 

del wakeup_tablep ptr; 

del 1 wakeup_table aligned based (wakeup_tablep) , 
2 wake_map (0:127) bit (1) unal, 
2 mbz bit (16) unal ; 



I Padding 

I Many hardcopy terminals handle normal characters at line speed 
I But require more time for carriage movement 

I Padding (i.e. delay) characters can be sent to allow time for 
carriage movement 

J Padding is done with NUL characters, which terminal discards 

I Padding can be done for CR/LF, Tabs, BS, FF 

I Specified in number of delay characters, or number of delay 
characters per column 

I Padding requirements are different at different speeds 

I Determining padding requirements is usually a matter of guessing and 
experimenting 

I Padding for output is done in Ring 0 

I Padding for echoed characters is done in FNP 

I Can be done for any type of line, but only makes sense for 
asynchronous lines and X.25 subchannels 
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I For X.25 no padding will be done for echoed characters 
I Not a problem 

I But X.25 does not know speed of terminal, only of multiplexed line 
I This has bad effects for padding 
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Delays 

Extract From Terminal Type File 

terminal_type : ... 



bauds : 


110 


133 


150 


300 


600 


1200 




vert_nl_delays : 


0 


1 


1 


5 


9 


18 




horz_nl_delays : 


0.00 


0.012 


0.025 


0.019 


0.060 


0. 


120 


const_tab_delays : 


0 


0 


0 


0 


2 


3 




var_tab_delays : 


0 


0.180 


0.250 


0.250 


0.500 


1. 


000 


backspace_delays : 


0 


0 


0 


0 


1 


2 




vt_f f_delays : 


9 


24 


29 


59 


100 


200 





Extract from tty_convert.incl.pll 
Used for get_delay and set_delay control orders 

del DELAY_VERS ION fixed bin int static options (constant) init (1) ; 

del 1 delay_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 delay like delay; 

del 1 delay based aligned, 
2 vert_nl fixed bin, 
2 horz_nl float bin, 
2 const_tab fixed bin, 
2 var_tab float bin, 
2 backspace fixed bin, 
2 vt_ff fixed bin; 



Advanced MCS User Features 



tty_ Modes and Control Orders 



F86 Page 3 



I Output Flow Control 

I Some terminals cannot accept output as fast as Multics can send it 
I For synchronous lines, this is handled by protocol 
I For asynchronous lines, several modes exist to solve the problem 
I These solutions are not valid for X.25 

I Flow control must be between PAD and terminal 
I No X.25 parameters for this problem 
I All flow control for asynchronous lines is handled in FNP 
I oflow mode 

I Turns on either of the two types of output flow control 
I ETB/ACK output flow control 
I Suspend-Resume output flow control 
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ETB-ACK Output Flow Control Protocol 

Characters 
Sender sent Meaning 

Multics: thisisETB Here's a block of output for you. 

(Silence while Multics waits for OK to resume.) 

Terminal: ACK OK, I can take another block of up to 256 characters. 

Multics: theoutETB Here's a block of output for you. 

(Silence while Multics waits for OK to resume.) 

Terminal: ACK OK, I can take another block of up to 256 characters. 

Multics: putforETB Here's a block of output for you. 

(Silence while Multics waits for OK to resume.) 

Terminal: ACK OK, I can take another block of up to 256 characters. 



tty_ Modes and Control Orders 
Advanced MCS User Features F86 Page 3- 



Suspend/Resume Output Flow Control Protocol 



Character 
Sender sent Meaning 



Multics : 


t 


Here's a character for you. 


Multics : 


h 


Here's a character for you. 


Multics : 


i 


Here's a character for you. 


Multics : 


s 


Here's a character for you. 


Multics : 


i 


Here's a character for you. 


Multics : 


s 


Here's a character for you. 


Terminal : 


X-OFF 


Wait, I can't handle any more for the moment 



(Silence while Multics waits for OK to resume.) 



Terminal : 


X- 


ON 


OK, I can handle some more now. 


Multics : 


t 




Here's a character for you. 


Multics : 


h 




Here's a character for you. 


Multics : 


e 




Here's a character for you. 


Multics : 


o 




Here's a character for you. 


Multics : 


u 




Here's a character for you. 


Terminal : 


X- 


OFF 


Wait, I can't handle any more for the moment 


Multics : 


t 




Here's a character for you. 



(Silence while Multics waits for OK to resume.) 

Terminal: X-ON OK, I can handle some more now. 

Multics: p Here's a character for you. 

Multics: u Here's a character for you. 
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Output Flow Control 
Extracts From Terminal Type File 



output_suspend: A S; output_end_of_block: ETX; 

output_resume : A Q; cutput_acknowledge : AGK ; 

buffer size: 256; 



Extract from flow_control_info . incl.pll 
Used for get_ofc_info and output_f low_control_chars control orders 

del 1 output_flow_control_info aligned based, 
2 flags unaligned, 

3 suspend_resume bit (1) , 

3 block_acknowledge bit (1) , 

3 mbz bit (16), 
2 buffer_size fixed bin (18) unsigned unaligned, 
2 s usp end_o r_e tb_s e q unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3), 
2 resume_or_ack_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3) ; 
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I Input Flow Control 

I Multics normally expects asynchronous lines to send data slowly 
I At typing speed 

I Some terminals and microcomputers can send input to Multics at line 
speed 

I Multics cannot always keep up 

I For synchronous lines, this is handled by protocol 

I For asynchronous lines, several modes exist to solve the problem 

I These solutions are not valid for X.25 

I Flow control must be between PAD and terminal 
I No X.25 parameters for this problem 

I All flow control for asynchronous lines is handled in FNP 
I blk_xfer mode 

I For some terminals that send a screenful of data 

I Data must be bracketed by special characters 

I If read with a get_chars operation, whole screenful is returned 
I Causes bigger input buffers to be allocated 
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Block Transfer 
Extract From Terminal Type File 



terminal_type : ... 

f raming_chars : STX ETX; 

Structure for get_framing_chars and set_framing_chars control orders 

del 1 framing_chars aligned, 

2 frame_begin char (1) unaligned, 
2 frame_end char(l) unaligned; 



I iflow mode 

I Suspend- Resume input flow control 

I Same as used in output flow control 
I 1- second timeout possible 

I Causes bigger input buffers to be allocated 
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Suspend/Resume Input Flow Control Protocol with Timeout 



Character 



Sender 


sent 


Meaning 




Terminal : 


t 


Here's a character for you. 




Terminal : 


h 


Here's a character for you. 




Terminal : 


i 


ricXc S it CnalaCLCi 1QI you.. 




Terminal : 


s 


nti.Lt; o d t ildl. dt LcL 1UI VUU. 




Terminal : 


i 


neire a a cuaiacLet loi you.. 




Terminal : 


s 


UBie o ex CUcl.LclO tcj. 1UI yOU. 




Multics : 


X-OFF 


Walt , X t-dil L. IleiIlU.lt; eilly illO.Lt; lUi 


Luc moment 


(Silence while 


nuiuics waits ior ujs. to j_BSume . ) 




Multics : 


X-ON 


OK, I can handle some more now. 




Terminal : 


t 


Here's a character for you. 




Terminal : 


h 


Here's a character for you. 




Terminal : 


e 


Here's a character for you. 




Terminal : 


i 


Here's a character for you. 




Terminal : 


n 


Here's a character for you. 




Multics : 


X-OFF 


Wait, I can't handle any more for 


the moment 


Terminal : 


P 


Here's a character for you. 




(Silence while 


Multics waits for OK to resume . ) 




Multics : 


X-ON 


OK, I can handle some more now. 




(Silence for one second) 




Multics : 


X-ON 


I repeat, I can handle some more now. 


Terminal : 


u 


Here's a character for you. 




Terminal : 


t 


Here's a character for you. 
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Input Flow Control 
Extract From Terminal Type File 



terminal_type : . . . 



input_suspend: S; 
input_resume : A Q ; 



Extract from f low_control__inf o . incl . pll 
Used for get_ifc_info and input_flow_control_chars control orders 

del 1 input_flow_control_info aligned based, 
2 suspend_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3) , 
2 resume_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3) , 
2 timeout bit (1) ; 
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I Parity 

I Normally send even parity, ignore input parity and strip input parity 
bits 

I All parity is handled in FNP 
I 8b it mode 

I Affects input parity 

I Inhibits stripping of parity bit 

I Treat parity bit as 8th data bit and receive any 8 -bit sequence 
I oddp mode 

I Affects output parity 

I Generates odd parity instead of even 
I no_outp mode 

I Affects output parity 

I Generates no parity bits 

I If used with rawo any 8 -bit sequence can be sent f 
I Pseudo -modes 
I default 

I erkl , can , A rawi , A rawo , A wake_tbl , esc 
I init 

I All modes off, except 1150 
J force 

I Hide errors in following modes 

I force , replay , polite works on async and X.25 lines 
I Miscellaneous Orders 
I hangup 

I Break connection with terminal 
I interrupt 
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I Send break to terminal 




I get_channel_info 




I start 



I Sends an extra wakeup 

I Should be used by programs that wakeup and do terminal I/O 
I terminal_info 

I Get information such as line speed 
I write_status 

I Find if any buffers waiting to be sent to terminal 
I read_status 

I Find if any input buffers waiting to be read 
I abort 

I Flush input and output buffers 
I resetread 

I Flush input buffers 
I resetwrite 

I Flush output buffers 
I get_event_channel 

J Find out event channel for wakeups 

I Useful if need to wait on more than one channel 
I set_event_channel 

{ Change event channel used 

| Useful if want to use event-call channel instead of event-wait 



channel 
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h tty_ attach description 

I tty_ {device} { -control_args} 
I tty_ LINE 

I Attach LINE as slave line 

J LINE can be generic destination 

I tty_ LINE -destination DESTINATION 

I Attach LINE as autocall line with specified phone number or network 
address 

I LINE can be generic destination 
I tty_ -dial_id STR 

I Wait for 'dial STR' on a login line and attach 
I tty_ -login_channel 

I Attach login channel without knowing name 
I -resource STR 

I Ask for line of a certain speed 
I -no_hangup_on_detach/ -hangup_on_detach 

I Default is -hangup_on_detach 
I -suppress_dial_manager 

I Use if process already has line owned or on loan 

I Used by Initializer 

1 Used for login channel 

I Used if dial_manager_ calls have already been made 
I -no_block 

I Never go blocked on input or output 
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MCS Ring 0 Internals 

Databases 
I tty_buf 

I Wired, contains most wired data for Ring 0 MCS 

I All information used during interrupt handling must be wired 
I Buffers 

I wtcbs ~\rj Tikk^J <e*W «'ook 

I LCT C©e>''C«' 
I Size is specified with PARM TTYB card in config deck 
I Default is 6K 

I Too small for average configuration 
I Size requirement can be calculated 

I CC75 Appendix C 
I Meters can show utilization i*>t>^ ^V*cl«l*,\ 
I Header contains meters and pointers to other data within tty_buf 

I LCT 

I Logical Channel Table 
I In tty_buf 

I One entry (LCTE) for each entry in CDT 

i For each FNP, multiplexer, non-multiplexed channel 

I LCTE has pointer to data for FNP, multiplexer, or 
non-multiplexed channel 

I WTCB or fnp_info or multiplexer -specific data 

I For FNP or mpx, this data contains pointers to descendant 
LCTEs 

I LCTE has pointer to LCTE of its parent multiplexer 
I Index of LCTE in LCT is called devx 
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I devx is what is used in hcs_ calls to identify line 

I LCNT 

Logical Channel Name Table 
Parallel to LCT 

In tty_area, a paged supervisor segment 
Each entry has names of channel 
Allows conversion of devx into channel name 
Used for error messages 
I WTCB 

Wired Terminal Control Block 
Primary database for non^ultiplexed channel 

Database pointer in LCTE of non-multiplexed channel points to it 
In tty_buf 

Data in WTCB used during interrupts, so it must be wired 

1 Event channel for waking up process when input arrives 

Pointers to active input and output buffer chains 

Contains pointer to TCB 

I TCB contains data about channel that is not used at interrupt 
time 

I TCB 

I Terminal Control Block 

I In tty_area, a paged supervisor segment 

I Has pointers to conversion and translation tables 

I Current and default 
I Bits to indicate modes set 
I tty_tables 

I A paged supervisor segment 
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I Contains tables used during input/output conversion and translation 
I Input translation 
I Output translation 
I Input conversion 
I Output conversion 
I Special 
I Delay 

I Tables are shared among lines (and hence among processes) 
I Often many lines use same tables 
I Reference count tells when table can be freed 
I fnp_info 

I In dn355_data, a wired supervisor segment 
I Pointed to by LCTE for FNP 
I Contains pointer to mailbox area for FNP 
I Contains pointer to PCB array for FNP 
I PCBs 

I Physical Channel Blocks 
I In tty_buf 

I Array of PCBs is pointed to by fnp_info 
I Indexed by channel number 
I Has pointer to LCTE of subchannel 
I Pointers to I/O buffer chains for subchannel 
I dn355_mailboxes 

I Contains mailboxes for each FNP 

I Used in FNP<->Multics communication 
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Ring Zero MCS Databases 



DATANET MBX 



TTY_BUF 
HEADER 



| Free 
•1->| Buffer 



I I Free | 
!-->| Buffer j 

.1 I I 



submbx i f 



submbx 



10 
I 

V 



PCBs 



FNP_INF0 |< 5--- 



+ 3- 





Input 
Buffer 



Input 
Buffer 



-11— >| 



| Output 
I Buffer 



| Output 
I Buffer 



WTCB 



12 



V 



TCB 



V 



---13- 



+.-14-- | 

V 



| Special | | Special | | Special | 
(Chars Tbl j - ->| Chars Tbl | - ->| Chars Tblj 

I I I I I I 



1) tty_buf.free 

2) tty_buf . lct_ptr 

3) lct.lcnt_ptr 

4 ) f np_inf o . mbx_p tr 

5 ) Icte . data_base_ptr 



6 ) lcte. ma j o r_channe l_devx 

7) pcb_array(n) . devx 

8) wtcb.fblock 

9) wtcb.write_first 

10 ) f np_inf o . pcb_ar r ay_p tr 



11) lcte.data_base_ptr 

12) wtcb.tcb_ptr 

13) tcb.specialrp 

14) tcb.df_specialrp 
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a Programs 

I tty_write 

I Called via hcs_$tty_write 

I Copies user's output from user ring buffer into buffer in tty_buf 
I May accept only part of user's output 

I User ring program must block, await wakeup and call again 
I Performs output conversion and translation 

I Calls next level of programs (usually fnp_multiplexer) to send data 
on to FNP 

I tty_index 

I Called via hcs_$tty_index, hcs_$tty_order 

I Handles control orders and mode changes 

I Pass on to FNP (via fnp_multiplexer) if order or mode is handled in 
FNP 

I fnp_multiplexer 

I Formats a mailbox and gives it to dn355 
I dn355 

I Manages DIA 

I Sends interrupts to FNP 

I Receives interrupts from FNP 

I Exchanges information with FNP using mailboxes 
I tty_interrupt 

I Called by dn355 for interrupts from FNP- 
I Tells FNP where to put input data 
I Allocates input buffers 

I Sends wakeup to process blocked for input when input is available 
I Touches only wired data, i.e. LCT, WTCB, buffers 
I tty_read 
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I Called via hcs__$tty_read 
I Usually called after wakeup is received 
I Performs input conversion and translation 
I Copies converted data from tty_buf into user ring buffer 
I tty_space_man 

J Utility to handle all allocation/freeing of buffers in tty_buf 
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a Multiplexing 

I Connections just described between 

I dn355 and tty_interrupt on interrupt side 

J tty_read/write/index and fnp_multiplexer on call side 

I are not always direct 

I For multiplexed lines, some intermediate processing is needed 

I Adding control information to blocks of data to be transmitted 

I Interpreting and removing control information from blocks of data received 

I Multiplexing is generalized using cmtv and channel_manager 

I cmtv 

I Channel Manager Transfer Vector 
I Is indexed by 

I Type of line (type of LCTE) 

I FNP, X.25 mpx, HASP mpx, non- multiplexed line, etc. 
I Type of operation 

I Read, write, interrupt, control, etc. 
I channel_manager 

I Is called by each program that needs to pass data up or down a level 
I For instance 

I By tty_write to send data from user down another level towards 
the FNP 

I By dn355 to send data from FNP up another level toward user 

I There are different entrypoints in channel_manager for the different 
types of operation 

I channel_manager looks in LCTE to get type of line 

I Uses type of operation and type of line to look in cmtv to find 
program to call 

I There is also priy_channel_manager , called for privileged operations 
such as loading an FNP 
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LCTE Chaining for Multiplexing 
Non-multiplexed subchannel 

Interrupt- s ide 
Operations 

II 
II 

V 

dn3 5 5 $ int errup t 



cmtv(write) : 
f np_mpx$ wr i t e 

cmtv( interrupt) 
dn3 5 5 $ interrupt | 



cmtv(write) : 
tty_write 

cmtv( interrupt) 
t ty_interrup t 



s 

cmtv(lcte. | 


LCTE 
"a" 


] | 

| lcte. | fnp_info 


channe l_type ) J 




| >| 

j data_base_ptr | 


A 

lcte. j 
maj_devx| 


+-• 


1 

pcb_array(n) .devx | 
• + 


1 
1 

V 




cmtv(lcte. | 

1 w 


LCTE 
a.hllO" 

A 


| lcte. | WTCB 


channe l_type) | 


| >| 

|data base ptrj 



tt v writs 

"A 



Call -side 
Operations 
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LCTE Chaining for Multiplexing 
X.25 Subchannel . 



Interrupt- side 
Operations 

II 
II 

V 

dn3 5 5 $ int e rrup t 



cmtv (write) : 
f np_mpx$wr i t e 

cmtv( interrupt) 
i dn35 5$ interrupt | 



cmtv (write) : 
x25_mpx$write 

cmtv( interrupt) 
; x2 5_mpx$ intrup 1 1 



cmtv(write) : 
tty_write 

cmtv( interrupt ) 
tty_interrupt 



cmtv(lcte. | 


LCTE 
"a" 


j lcte . j 


fnp_info 


channe l_type ) | 




j >j 

j data_base_ptr | 




A 

lcte. | 
maj_devx| 


+-- 


pcb_array(n) .devx 


I 
l 

1 

+ 


1 
1 

V 






cmtv (lcte, j 


LCTE 
n a.hl20" 


J lcte. J 


x25_info 


channe l_type ) | 


j ---- - - ->| 

j data_base_ptr | 




A 

lcte . j 
ma j devx | 
1 
1 

_l 


+- 




1 
1 

+ 


1 
1 

V 






cmtv(lcte. | 
• it? 


LCTE 
a.hlW 

A 


| lcte. | 
j >| 


WTCB 


channe l_typ e ) | 


| data_base_ptr [ 





tty_write 
A 



Call -side 
Operations 
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Multics-FNP Interface 

1 DIA Interrupts 
I Submailboxes 
I TIMW 











r 

0 




\ 




1 




3 




1 




s 








n 












10 


V : 


t i 










ft | T » ^ vy 



Mi; t Ti' c k 



%' 11 

To ^ K 
Hi ^/ r sx 
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FNP Internals 



h Programs 

I All work in the FNP is driven by interrupts 
I HSLA 

I Input from a line 

1 Status change for a line 

I DIA 

I Mailbox interrupt from Multics 
I Terminate interrupt from I/O started by FNP 
I Timer 

I No work ever seems to be done directly 

I Everything that needs to be done is put in a queue to be done later 
as time permits 
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FNP WORK SCHEDULING 
MASTER DISPATCHER- - INTERRUPT -DRIVEN 



INTERRUPT 
* 

I 

v 

+ + + 

| INTERRUPT VECTOR | 
+ + + 



V 

+---------+ + 

! 3 -WORD JUMP TABLE I 
+ + + 

I 

v 

+ + 

| SKED$INVP 
+ + + 



+ 



+ + + 

I SKED$MDISP +<* 
+--- + + 



* PENDING * 
^INTERRUPTS* 

* * 



+• 



+ + + 

| DIA_MAN$DTERM | 
j DIA_MAN$DMAIL | 
+ + ----+-----+ 

* * 
****** 

* 
* 
v 

************ 

* MAILBOX * 

* QUEUE * 

* * 
***** 



+ +. .^Avj + 

| HSLA MAN$HINTR | 



+-- 



* 
* 
v 



+--+-. 
* 
* 
* 
* 
* 
* 

V 



* TIMER 

* QUEUE 



************ / 

Kr*iK Jeter*' 



SECONDARY 
DISPATCHER 



+--+ 



-+■ 
* 

* * 

* * 

* .A. , . * 

* 
* 



************ 

* SOFTWARE * 

* STATUS * 

* QUEUE * 
************ 



************ 

* HARDWARE * 

* STATUS * 

* QUEUE * 
************ 
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FNP WORK SCHEDULING 



SECONDARY DISPATCHER—QUEUE DRIVEN 



MAILBOX * 
QUEUE * 



-k 
* 
* 
* 
* 
* 
* 
V 

■ + - 



* TIMER 

* QUEUE 
* 

*i 

* 
V 



1~ 



SECONDARY 
DISPATCHER 
--+ 



DIA$DGETWK 



-+ 

+<**** 



V 



INTP$ITEST 
INTPSIWRITE 



--+ 
I 

! 

--+ 



I 

V 



CONTROL_TABLES 

+ • 

i 

v 

--+ • 

MISC UTILITIES 

■ -------+ • 

* 



+ +----- 

| INTP$ITIME 
I 



v 

- + 

CONTROL TABLES 



+- + 

i 

v 

+---------+ • 

| MISC UTILITIES 

I 

+--- + • 

* 
* 

************ 



*********** 
★SOFTWARE * 

* STATUS * 

* QUEUE * 
*********** 

* 
* 
* 
* 
* 

-.+ * 

| * 

I * 
v v 

• + + + 

HSLA$HSTPRC | 

i 

+ + 

i 

v 



•+ 



INTP$ISTAT 



v 



*********** 

* DIA * 

* REQUEST * 

* QUEUE 
*********** 



v 

+ + 

| CONTROL_TABLES 



v 

+ • 

MISC UTILITIES 
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Three -Word Jump Table 



Interrupt 
Vector 



Handler 



addr (handler) 



addr (handler) 



addr (handler) 



addr (handler) 



addr (handler) 



addr (handler) 



tsy indirect 

> 

+ > 

I 
1 

+ 



iTC at intp time 



Handler 
Code 



Interrupt 
Vector 



tsy indirect 



Three -word 
Jump Table 



Handler 



addr (handler) 



addr (handler) 



addr (handler) 



addr (handler) 



addr (handler) 



addr (handler) 



IC at intp time 
tsy to handler 
ioc/devid/mod 



IG at intp time 
tsy to handler 



ioc/devid/mod 



IC at intp time 



tsy to handler 
ioc/devid/mod 



IC at intp time 
tsy to handler 
ioc /devid/mod 




■+ I 
I 

•--+ 
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I scheduler (sked) 

I Schedules work to be done 

I sked$invp is the primary interrupt handler. 
I sked$mdisp is the master dispatcher 
I sked$dspqur schedules work for later handling 
I The secondary dispatcher runs work queued by dspqur 
I hsla_man (hsla) 

I Controls HSLAs 

I hsla$hintr handles HSLA interrupts 
I hsla$hstprc does work queued at interrupt time 
I hsla$hdcw accepts output commands from control tables 
I hsla$hcfg handles configuration changes 
I hsla$hmode handles mode changes 
I hsla$hgeti handles replay and polite modes 
I dia_man (dia) 

I Controls the DIA 

I dia$dterm handles DIA terminate interrupts 

I dia$dmail handles DIA mailbox interrupts 

I dia$dgetwk does work queued at interrupt time 

I dia$denq accepts data to be sent to CS 
I interpreter (intp) 

I Control Tables Interpreter 
I control_tables , etc , 

I Implement the communications protocols 
I utilities (util) 

I Utility subroutines 
I melt 
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I COLTS hardware tests 
I trace (trac) 

I Puts trace information in trace table 
I meters (metr) 

I Collect meters for channel_comm_meters 
I init 

I FNP initialization program 
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h Databases 

I Communications Region 

I Global database for FNP 
I Pointers to other databases in FNP 
I IOM Table 

I Used during initialization and to refind HSIA Table to find TIB 

I TIB 

I Terminal Information Block 

I Main per -channel database 

I Contains data used by many programs 

I Stored in extended memory 

I TIB, SFCM and two buffers permanently allocated to channel are stored 
in a 256 -word page 

I Page is addressed using page table entry 4177 (addresses 77400-77777) 

I SFCM 

I Software Communications Region 
I Per -channel 

I Contains information for HSLA for channel 
I HWCM 

I Hardware Communications Region 
1 Per -channel 

I Contains control words for HSLA 
I Pointer to CCT for channel 

I CCTs are shared, similar to tables in tty_tables 
I Pointer to SFCM for channel 

J Stored in low-order memory, address known by hardware 
I HSLA Table 
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I Pointed to by IOM table 

I One two -word entry per channel 

I Entry contains pointer to TIB 

I Finding the TIB for a given channel is its main function 
I TIB Table 

I One 2 -word entry per channel 

I Not arranged in any particular order 

I Each entry contains a pointer to TIB and a pointer to outstanding DIA 
requests for channel 

{ DIA Requests are stored in low- order memory 

I TIB Table plus these DIA requests make up the DIA Queue 

I Buffers 

I Are mainly allocated In extended memory 

I Addressed using page table entry 4176 (addresses 77000-77377) 
I Free space chained from .crnxe 

I If no free space in extended memory, can use free space in low- order 
memory 

I Normally used for CCTs, DIA requests , etc. 
I Free space in low- order memory is chained from .crnxa 
1 Buffer Requirements 

I Can be calculated using CC75, Appendix B 

I There are meters to show utilization 
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FNP Databases Excluding I/O Buffers 
(Per -Channel Databases Shown for a.h205) 



640- -> 



+- . crttb- 




1000- -> 



2000- -> 



3000- -> 



3000- -> 
+5*16 



| Free 
- . crnxa->| Space 



| Free | | Free 
■>| Space !-->! Space 



| Free | | Free 
crnxs->| Space |-->| Space 



j Free | 
->j Space | 



I0M 


1 +- - 


Table 


1 1 




1 1 
| ---+ 




| ---+ 
1 1 



HSIA Tbl 
HSLA 0 




TIB | 




Table | 






+ 

1 




! 

V 



j DIA | j DIA J i BIA | 

(Request | >jRequest | >|Request j 

I I I ! I i 
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FNP I/O Buffers 



| Comm | | Free | | Free | | Free | 

j Region j-.crnxe->| Buffers |-->| Buffers |-->| Buffers j 

I I ! I I I I I 

I I 



HWGM 



| -h.sicO--- 
| -h. sicl — 
j -h.ricO — 
I -h.ricl-+ 



V 

icw~ 



V 



ICW 



I 

_v_ 

ICW 



J Input j 
| Buffer 1 | 



I I 



j Input 
| Buffer -2. 

0 



| Output 
(Buffer 1 



V 

! ICW I 

I I 

_l 

| Output 
j Buffer -2- 
I 0 



! 6 I I 

+---sf . ib1--+ +--sf .ob$---+ 

I I 0 
•--sf j j +--sf.oWtr-- 



+- -h.sfcm- 



->| SFCM |<- 
! 

+-sf .tib*- 
i 

+ 



t.dcp- 



V 



+t. deist 
V 



| Buffer j i Buffer j j Buffer j 
(for DIA |->|for DIA |->|for DIA | 

1 I I I I S&g£ ^ 1 




-+ 

I 
I 



-t.sfcm*-+ 



| Echo 
•t.echo-->| Buffer 



V 



III I 

■--t.icp--+ | | +--t.olst -.--+ 

+--t.ilst--+ j | 
j t . ocur ! 

I I I 

V V V 



Input | | Input | | Input | | Output | | Output | | Output 
Buffer |->j Buffer |->j Buffer | j Buffer [->| Buffer |->| Buffer 
I I I I I I I I I I 



■PrPR 
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FNP MEMORY LAYOUT 

Start Length Explanation 

0 420 Interrupt Vectors 

420 20 Fault Status Words 

440 20 Fault Vector 

450 20 Mailboxes 

475 1 Page Table Address 

500 140 LSIA HWCMs 

640 136 Communication Region 

776 2 Missing Module Code 

1000 #hslas*1000 HSIA HWCMs 

.crept 200 CPU Page Table 

.criom 40 IOM Table 

.criom+15,* #hslas*100 HSIA Tables 

. crmod- 22 variable Program modules 

.crttb #lines*2 TIB Table 

.crbuf variable Low memory buffer pool (for TIB extensions, 
(=.crtte) CCTs, DIA queue, delay tables) 

77000 77777 Unused Pages 

100000 #lines*400 SFCM/TIB pairs, I/O Buffer pool 

100000+ variable I/O Buffer pool 
#lines*400 

.crtrb .crmem- Trace Buffer 
. crtrb 
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display_fnp_symbols : proc ; 

/* Program to list all the symbols which are understood by debug_fnp */ 
/* Coded 19 August 1980 by Jim Homan */ 

del i fixed bin; 

del ioa_ entry options (variable) ; 
%page ; 

% inc lude debug_f np_da t a ; 
%page ; 

symbol_tablep - addr (db_fnp_symbols_$db_fnp_symbols_) ; 
call ioa_ ("Symbol Value Length Explanation"/") ; 

do i - 1 to symbol_table . cnt ; 

exptextp — addrel (symbol_tablep , symbol_table . entry (i) . explain) ; 
call ioa_ (" A 10a A 10o A 10d A a" , symbol_table . entry (i).name, 

symbol_table . entry (i) .value, symbol_table . entry (i).len, 

exp text. data) ; 

end; 

end display_fnp_symbols ; 
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Communications Region 



Name 


Address 


Length 


Explanation 


. crldt 


C Art 

640 


i, 
4 


date and time of binding 


. crbdt 


en. a 
644 


4 


date and time of bootloading 


. crbuf 


a crt 
650 


1 


starting address of buffer area 


. crmem 


/CI 

651 


1 


last location of memory 


.crnbf 


652 


1 


number of buffers available 


. criom 


/CO 

65J 


1 


start of iom table 


.crnhs 


654 


1 


number of hsla's configured 


. crnls >- 


655 


1 


number of lsla ' s configured 


. crcon 


c / 

656 


1 


console enabled flag 


.crmod 


657 


1 


starting address of module chain 


. crnxa 


660 


1 


ptr to next available buffer 


. crtra 


661 


1 


trace entry enable mask 


. crtrb 


662 


1 


base address of trace table 


. crtrc 


663 


1 


next available location in trace table 


. crreg 


664 


1 


disaster fault register storage location 


. crttb 


665 


X 


location of tib table 


. crtte 


666 


1 


location of end of tib table 


. crdly 


/ / ^ 
667 


1 


head of delay table chain 


. crver 


£ "7rt 

670 


2 


mcs version number, 4 chars 


. crbrk 


£79 


1 
J. 


addr of breakpoint control table 


. crtsw 


O / J 


1 


if non-zero, tracing will cease 


. cmxs 


6/4 


1 


next free small block 


. crmbs 


6/5 


1 


number of buffers devoted to small space 


. erect 


bib 


1 


address of first cet descriptor 


. crskd 


o / / 


J. 


aooress or scneuuier aaua diock 


. cretb 




1 


list of echo -negotiation bit tables 


. crept 


7H1 
/ UX 


-L 


auuxess ox cpu page cauxe 




709 


1 

X 


aHH^OCC /%"F TT3T*"f J3*K1 A OTI11 T"\ 2 (TO f~ 1 £S OTlt"rV 
auULCOo Ui. VaJ LctL^-LC i^JJU page UaUlc C 1 1 1 — L y 


. crtsz 


703 


1 


qi° 7g r»-F l-raco data ^" k1 ' , ffer 


. crmet 


704 


1 


non-zero if metering enabled 


. crtdt 


705 


1 


address of tib for t&d executive channel 


.crbtm 


706 


1 


address of time meters for getbuf/frebuf 


.crnxe 


707 


1 


next available space in extended memory 


. crbpe 


710 


1 


buffer paging window table entry 


. crcpr 


760 


14 


copyright notice 
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TIB 



Nam© 


Address 


Length 


Explanation 


t . stat 


0 


1 


holds current line status 


t.fls 


1 


1 


flag word 


t . f lg2 


2 


1 


second word of flags 


t . cur 


3 


1 


current address in control table 


t . line 


4 


1 


10 bit line number 


t . iCD 


5 


1 


first buffer in input chain 


t. ilst 


6 


1 


last buffer in input chain 


t . icpl 


7 


1 


count of buffers in icp chain 


t . icch 


10 


1 


address of next input character 


t.elnk 


11 


1 


link to tib extension 


t . rep 


11 


1 


replay chain pointer (share t.elnk) 


t . ocp 


12 


1 


addr of output chain from cs 


t . ocur 


13 


1 


addr of current output buffer 


t.olst 


14 


1 


addr of last buffer in output chain 


t . occh 


15 


1 


addr of next outout character 


t . OCTlt 


16 


1 


count of buffers in t . ocur 


t . type 


17 


1 


line type 


t . time 


20 


2 


time at which next timeout will occur 


t . reta 


22 


1 


return address from calsub 


t . dewa 


23 


1 


addr of dew list to 'execute' 


t . dcwl 


24 


1 


length of dew list 


t . echo 


25 


1 


echo buffer address 


t.dcp 


26 


1 


addr of message chain for cs 


t. dlst 


27 


1 


last buffer in messge chain for cs 


t . f tse 


30 


1 


first time slot entry in Isla table 


t . sf cm 


30 


1 


pointer to sfcm for hsla lines 


t .bent 


31 


1 


counting temporary 


t . brkp 


32 


1 


pointer to current break list 


t . pos 


33 


1 


current carriage position 


t . char 


34 


1 


nendins line control char flsla onlv^ 


t . ecch 


34 


1 


address of current echo char (hsla only) 


t . cntr 


35 


1 


counter for control tables 


t fle3 

U.J. igj 


36 


1 


t"biT*fi tfoffl o~F "FT flc^ 


t . dtp 


37 


1 


"oointeir to delav tab! £» foT fchi ^ line* 


t . frmc 


40 


1 


framing chars (2 chars) 


t . dcpl 


41 


1 


numb ft t° of buffeTS in dco cbain 


t.scll 


42 


1 


screenline length left, for echo neg. 


t . sncc 


43 


1 


Echo negotiation sync ctr . 


t . entp 


44 


1 


Echo negotiation break table ptr 


t.ifch 


45 


1 


input flow control characters 


t . of ch 


46 


1 


output flow control characters 


t . omct 


47 


1 


output message count (for flow control) 


t. itim 


50 


2 


time of last call to inproc (2 words) 


t.metr 


52 


1 


address of metering area 


t.abfO 


53 


1 


absolute address of first permanent buffer 


t.abfl 


54 


1 


absolute address of first permanent buffer 
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Flags for tib.flg 



Name 


Address 


Length 


Explanation . 


tf osus 

wi. ww WwJ 


-400000 


1 


output suspended 


tf ect)x 


200000 


1 


echoplex mode 


tf isus 


100000 


1 


input suspended 


tf eotx 


40000 


1 


eot expected from 2741 


tf auto 


20000 


1 


this Is hsla autobaud line 


tfwabt 


10000 


1 


do write abort 


tf tbec 


4000 


1 


do space echo on tab 


tfcrec 


2000 


1 


do cr echo on If 


tflfec 


1000 


i 


do If echo on cr 


tfctrl 


400 


1 


do kybd/printer addressing 


tfquit 


200 


1 


send nl on line break 


tflisn 


100 


1 


answer the phone 


tfhang 


40 


1 


hangup this line 


tfprtr 


20 


1 


printer addressed 


tfkybd 


10 


1 


keyboard addressed 


tffdpx 


4 


1 


full duplex mode 


tfbel 


2 


1 


send bell as next echoed character 


tfwrit 


1 


1 


output chain present 


tfdlup 


20 


1 


line is on dialup modem 






Flags for tib.flg2 


Name 


Address 


Length 


Explanation 


tfpfnl 


-400000 


1 


line is in prefixnl mode 


tf sf tr 


200000 


1 


terminal is shifting device 


tffip 


100000 


1 


frame in progress 


tffrmi 


40000 


1 


frame mode 


tfmrcv 


20000 


1 


'message' receive mode 


tf crcv 


10000 


1 


'control' receive mode 


tfblak 


4000 


1 


asynchronous block acknowledgement 


tfplit 


2000 


1 


polite mode 


tf rpon 


1000 


1 


replay is occurring now 


tfmlv 


400 


1 


replay mode 


tf ups f 


200 


1 


terminal is upshif ted now 


tfofc 


100 


1 


output flow control mode 


tfifc 


40 


1 


input flow control mode 


tfacu 


20 


1 


do dial out 


tfrabt 


10 


1 


do read abort 


tfercv 


4 


1 


enter receive mode 


tfdild 


2 


1 


terminal is dialed up 


tfxhld 


1 


1 


hold transmit on 
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Flags for tib.flgS 



Name 


Address 


Length 


Explanation 


tfmask 


20000 


1 


channel has been masked for excessive interrupts 


tfabfl 


10000 


1 


t abfl available 




4000 


1 


nutnut TP^timp npntiiTiD" ('waif in? until f to^ 


tf soip 


2000 


1 


suspension of output in progress 


tfabfO 


1000 


1 


t.afbO available 




400 


1 


odd T>aT"f tv 

W*XW k/ClX X, W ¥ 


tf8out 


200 


1 


don't strip output parity- 


tf8in 


100 


1 


don' t strip input parity- 


tfsked 


40 


1 


input timeout routine scheduled 


tfbral 


20 


1 


break on all characters 


tf echo 


10 


1 


echoing has priority over output (lsla) 


tflcnaT 


4 


1 


keep parity bits' 


tf itim 


2 


1 


timeout if input stops 


tfbkpt 


1 


1 


line is stopped at breakpoint 






Flags for tib.stat 


Name 


4lVi\*A. W W W 


Length 


Explanation 


tsf era 

W w J» JU VJ 


20000 


1 


acu call request 


tsf rts 


10000 


1 


request to send 


tsf tre 


4000 


1 


tally runout enable (hdlc) 


tsf sxt 


4000 


1 


supervisory transmit 


tsfdtr 


2000 


1 


data terminal ready 


tsfbrk 


1000 


1 


send line break 


tsf xmt 


400 


1 


transmit mode 


ts f rev 


900 


1 


receive mode 


tsftrm 


100 


1 


send terminate status 


tsfmrk 


40 


1 


send marker status 


tsf St 


20 


1 


store status 


tsfsrc 


10 


1 


supervisory receive 


tsfdsr 


4 


1 


data set ready 


tsfcts 


2 


1 


clear to send 


tsfed 


1 


1 


carrier detect 



FNP Internals 



Databases 



F86 Page 6-16 



SFCM 



Name 


Address 


jLengcn 


xixp x a.ria. u x 0x1 


s f . licm 


u 


i 

X 


duul O I. Qwcm 


sf . nx a. 


x 


X 


3.QOX 01 next. avaiiaDie queue entLy 


sf . nxp 


o 
Z 


X 


aciux 0 x riex u queue en u x y to pxuceoo 


sf . tly 


j 


1 

X 


uaxxy ox scatus queue 


St . tlD 


A 


1 
I 


addr of tib fot this line 


SI . Ilg 


c 


1 
X 


flag word 


St . 1DU 


c 
o 


1 
X 


pointet to input buffet 1 


St . 1D1 


7 


1 
X 


p 0 int. ex u 0 xxipviu dux rer z 


s t . obO 


1 fi 
JLU 


1 

X 


yUXllLcL UU L/LiUp LL U X 


SI. . OD1 


1 1 
11 


1 

X 


pwxuuex uuupuL uuiici £ 


st . pew 


1 9 


1 

X 


CUxxenu pew cXlkx woiu 




X J 


1 

X 


L. dUUL 1UL L-liXd lXilC } XX LLKJ LL l»C1U 


SI . IT C l_ 


J,'+ 


1 

X 


vQ-na o +~ nmmf* "fni* ct"at*iie nnoiio **y\t£i?"*FT rvrac 
XepedC CUUILL lUl o LaLUo IjUcut? UVclllUWo 


SI . U.SX 




1 

X 


aUUieSb Ul Libia UaUlc eilUXy 1U1 Lillo XXIlti 


sf . DSZ 


1 fi 
xo 


1 
X 


max Duiier size 


SX . lUs 


1 7 
x / 


1 

X 


uuiici ox^c cu Ue useu u.u.1 Xiig 11 ctiiic xiipuu 


sf . nuns 


zu 


1 

X 


maximum synchronous message size 


*3 -I- • Ud6 


20 


1 


fMITTPTlf" a CJVnplTrnnni I <3 llll'F'FfaT' 817P 


sf .rms 


21 


1 


remaining unallocated message length 


sf .nic 


21 


1 


char, address of next asynchronous input char 


sf .noc 


22 


1 


char address of next asynchronous output char 


sf . ssl 


23 


1 


number of entries in software status queue 


sf . cfg 


24 


2 


2 words for config pew 


sf . sta 


26 


12 


hardware status q, sicw here 


sf .waq 


42 


40 


wrap around queue, software status q 
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Flags for sf.flg 



Name 


AQuxess 


Length 


Explanation 


snzncu. 


-H-UUUUU 


i 
l 


uses hdlc channel board 


siissd 


zuuuuu 


l 


copied alternate buffer back to output chain 


sf fnib 


1UUUUU 


1 


need to allocate new input buffer (s) 


sffofr 


40000 


1 


old setting of tffrmi (lines up on tffrmi) 


sffmsp 


20000 


1 


marker status pending 


sffsyn 


10000 


1 


any synchronous line type 


sff sqo 


4000 


1 


status queue overflow pending 


sffbsc 


2000 


1 


binary synchronous device 


sffstp 


400 


1 


stop channel, rxmit done 


SIICCc 


zuu 


1 


dynamic (sharable) cct in use for channel 


sffech 


100 


1 


tab, cr, If echo going on now 


sffebd 


40 


1 


ebedic data code on this line 


sff set 


20 


1 


short cct flag 


sffisc 


10 


1 


inactive subchannel flag 


sffcoi 


4 


1 


on if alternate output icw is active 


sffcii 


2 


1 


on if alternate input icw is active 


sffskd 


1 


1 


status processor is scheduled 
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HWCM 



Name 


Address 


Lfc TIP' til 


Explanation 


n . i- icu 




0 


pX.XlilelLjr icCclvc ltw 


h.ricl 


2 


2 


alternate receive icw 


h.sicO 


4 


2 


primary send icw 


h.sicl 


6 


2 


alternate send icw 


h.baw 


10 


1 


base address word 


h„sfcm 


11 


1 


software comm. region address 


h.mask 


12 


2 


mask register 


h . aicw 


14 


2 


active status icw 


h . cnf g 


16 


2 


configuration status 
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FNP Line Meters 



Name 


A W "V - " a c c* 


T an < r Hh 
JUCllgUQ 


ill X.p X ell la. 1- X yj 11 


m . ckjl 


n 


2 
x 


LUUlUxdUXVc XCllgL.il UX Uld ICt^UBSL l^UCUC 


in. cLcju 


9 


0 

c 


upuatco UX 1U.UMX 


m net" 

ill . llO U 


A 
•+ 


2 
x 


OIITTlllI Tlfi of T>f*Tlfil Tl? O f~;3 "f~ T 1 C 
^UUlUxAUl VC llv ■ vsx ucuuxiig s uauuo 


m.nsu 


0 


Z 


updates ox m.nsx. 


m , over 


1 A 
xu 




output overlaps 


m.par 


11 


1 

X 


parley errots 


m • ssqo 


1 9 


1 

X 


eAT"fT!iTaTa ef"ot"iie ntifino avatt 1 mjc 
SUlUwdlc aUdUUs l^UcUC UVCillUWB 


m.hsc[o 


iJ 


i 

X 


liay/^T.TaT"Q miQllQ Aty/jvr 1 ftTJC 

UaiUWalc SoaI.Ua (jUcUc OVcrilOWS 


III . -LIleLX 


i'r 


1 

X 


t nni 1 1" all Aoa^i nn Fai 1 iiTpe 
lupuu aixu^auiuu xetxxuxcs 


in . cijx 




1 

X 


LUlLCllL XGllgLll Ul Ula ICv^UCoU <^UICU-C 


ni . exh 


ID 


0 
X 


p 31 1 e t" ef~at~iie 
C&UdUs L oUaLUB 


ill . is. t-C 


20 


1 
X 


c r» ■Ff-TjTa fo vfp et"ahie 


ill . J.eiig 


22 


1 


1 an cy1"Vi o"P 00111711011 mpfpf? /" mii cf hp pvpti^ 
icugwii vx vUuuuwu y tin io c lsc c v ctiy 


111 • J. c *v 


22 


2 


nrp. «3"5rTl 1 c; f o t*P Q 


111 . CUU1 


2& 




CCilU LfULlCL UvclliUWo 


m nit i f~ 
111 o ijul L. 


2fi 


1 

X 


Vk^l 1 — mil f"*c 


TTl st c;tt1 
111 • as y X 


30 


1 


LULal icugtu w x apyuuiii. vuuup iuclcip 


to n T nri 
111 o 11X111 


22 


2 

X 


UUUIOCI vJX XlljJUU IWSooa-fcLcSo 


iBo iml 


ZM- 


Z 


cumulative length of input 


ie . mini 


ZO 


1 


minimum length of input message 


m.maxi 


Z / 


1 


maximum length of input message 


m.nom 






number of output messages 


m. oml 


"JO 

jZ 


Z 


cumulative length of output 


m . mino 


o/l 
j4 


1 


minimum length of output message 


m.maxo 


oc 
JJ 


i 
X 


maximum length of output message 


m . cntX 


JO 


o 

X 


ursu ujrp© oi couiiLcr 


m . cnt 2 


40 


2 




m.cnt3 


42 


2 


third type of counter 


m. cnt4 


44 


2 


fouftfi t!VT)p o-F r«oi inter 


m . cnt5 


46 


2 


fifth type of counter 


m . cnt6 


50 


2 


sixth type of counter 


m . cnt7 


52 


2 


seventh type of counter 


m„cnt8 


54 


2 


eighth type of counter 


m.synl 


56 


1 


total length of synchronous meters 
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MCS Metering 



I display_cdt 

I tty_lines 

I system_comm_meters 

I channel_coimn_meters 

I debug_fnp 



I bstat 

I sample_ic 

I fnp_idle 
I interrupt_meters Ra^!S 8 ^'^^ ' 
I fnp_throughput ^T^oTt^^ 
I meter fnp idle ^ {L^T^ f\( Td^T^J I 
I display_fnp_idle J TO ^ Q 
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display_cdt 



CDTE at 515 | 2460 

in_use: -fv r 
name: 

Multiplexer data: 
service_type : 
mpx_type : 
state: 

initial load: 

last load: 

last crash: 

load started: 

flags . go : 

flags . listening: 

current_service_type : 

current_mpx_type : 

n_bootloads : 

last_tbf : 
comment : 
charge_type : 
service_type : 
current_service_type : 
dim: 

line_type : 
terminal_type : 
baud_rate : 
f np_no : 
event : 
tra_yec : 
count : 
twx: 
state : 

current_terminal_type : 
cur_line_type : 
tty_id_code : 
process : 
next_channel : 
n_dialups : 
n_logins : 
dialed_up_time : 
dialup_time : 
recent_wakeup_count : 
r e c en t_wakeup_t ime : 



1 (hung up) 
a.h006 

I (active) 

II (x25) 
4 (up) 

02/09/84 1533.7 hfh Thu 
02/20/84 1730.2 hfh Mon 
02/20/84 1601.2 hfh Mon 
02/20/84 1730.2 hfh Mon 
1 
1 

I (active) 

II (x25) 
11 

293 

X.25 major channel 

0 (none) 

8 (multiplexer) 
8 (multiplexer) 

1 (tty) 

17 (X25LAP) 
X25_TRANSPAC 
1200 
1 (a) 

000330011502407777000673 

0 () 
0 

0 

0 () 

0 (none) 

77777|1 

0 

0 

0 

0 hrs 0 mins 0 sees. 

never 

0 

never 
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CDTE at 515 | 2620 

in_u.se : 

name: 

comment : 

charge_type : 

service_type : 

current_service_type : 

dim: 

line_type : 
terminal_type : 
baud_rate : 
f np_no : 
event : 
tra_vec : 
count : 
twx: 
state: 

current_terminal_type : 
cur_line_type : 
tty_id_code : 
process : 
next_channel : 
n_dialups : 
n_logins : 
dialed_up_time : 
dialup_time : 
recent_wakeup_count : 
recent_wakeup_time : 



display_cdt 



1 (hung up) 
a.h006.d01 

X.25 dial_out sub -channel 

0 (none) 

6 (dial out) 
6 (dial out) 

1 (tty) 
0 (none) 

300 

0 () 

000470002046407777000151 
18 (wait_slave_request) 
0 

77 

1 (hung up) 



0 (none) 
none 
77777 | 1 
0 

1649 r u us 6** nut? sk»oJ frSeC^fr:^* 

1208 W*' r h * ut i fr /C e Mw«it^^ 
210 hrs 58 mins 37 sees . 
02/20/84 1623.0 hfh Mon 
1 

02/20/84 1730.2 hfh Mon 
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display_cdt 



CDTE at 515 | 3560 



in us 6 1 


5 (loeeed in & oroc) 


name : 


a.h006.001 


COTTITPfiTlt " 


X.25 login sub -channel 


charge type : 


0 (none) 


service_type : 


1 (login) 


current service type : 


1 (login) 


dim: 


1 (tty) 


line type: 


0 (none) 


terminal type : 


ASGII CRT 


baud rate : 


1200 


f np no : 


0 () 


flags . attributes : 


dont read answerback , che< 


event : 


000330011356407777000132 


tra vec : 


8 (wait logout sig) 


count : 


1 


twx : 


62 


state : 


5 (dialed up) 


current terminal type : 


ASCII CAPS 


cur_line_type : 


1 (ASCII) 


tty_id_code : 


none 


process : 


366 |1330 


next_channel : 


0 


n_dialups : 


2788 


n_logins : 


2180 


dialed_up_time : 


886 hrs 32 mins 32 sees. 


dialup_time : 


02/20/84 1801.3 hfh Mon 


recent_wakeup_count : 


2 


recent_wakeup_time : 


02/20/84 1801.6 hfh Mon 



MCS Metering 



F86 Page 7-4 



interrupt_meters 



Total metering time 0:10:19 



T AM" /""Vl 


lnt 


Avg Time 


a a"DTT 


JName 




A C. 

A 0 . 


1 
1 


1 "7Q <^ 


a AA 

u . uu 


T AM A 
IUWL A 


special 


A Q 

A o . 




A ?i;o 
U . jjZ 


A 1 "3 


dska 




A Q 


1U 


U . *t j / 


U . UU 


dska 




A 12. 


90 


0.563 


0.01 


dskc 




A 14. 


174 


0.531 


0.01 


dska 




A lb . 


z_> /y 


A K/.tZ. 

U . 04- D 


A Ol 
U . Z 3 


as Kb 




A T "7 

A 1/ . 


£ a 
oU 


u . 4-y d 


A AA 


as kd 




A io . 


324 


u . 5/y 


A AO 
U . 03 


dskd 




A 20. 


2825 


0.570 


0.26 


dskd 




A 22. 


418 


0.481 


0.03 


dskb 




A 23. 


1 


0.276 


0.00 


dskb 




A 26. 


9 


1.237 


0.00 


prta 




A 28. 


7748 


2.732 


3.42 


f np a 




Chan 


15656 


1.632 


4.13 






Ovhd 


15605 


0.159 


0.40 






Total 


15605 


1.796 


4.53 
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Total metering time 



sy s tem_comm_me ter s 
0:10:03 



THROUGHPUT 

Total characters input 
Total characters output 
Average length of input 
Average length of output 
Input characters preconverted 



before conversion after conversion 
5,041 4,705 
153,567 123,256 
5.1 characters 
73.3 characters 

0 (0.0% of total) 



ratio 
0.93 
0.80 



Number of calls 
Average time per call 
Average chars, processed 
Average chars, per msec. 



CHANNEL INTERRUPTS 

software "interrupts" 
average time (msec . ) 



TTY BUF SPACE MANAGEMENT 



read 
1,436 
2.13 msec. 
3.5 
1.7 



input 

3,243 
2.45 



output 
3,155 
1.02 



write 
2,495 
5.09 msec, 
61.6 
12.1 



other 

113 
2.36 



total 

6,511 
1.76 



r 



Total size of buffer pool 19,368 words 
Number of channels configured 191 
Number of multiplexed channels 18 

% of buffer pool in use current average 

input 8.3 8.4 

output 13 . 8 13 . 6 

control structures 51.1 51.2 



total 73.2 73.2 

^^ v ^vjQ_£fjv^l ^ f _ . - _ / /2 

Smallest amount nd free space ever 2,594 words (13% of buffer pool) S^t r\o> I 



allocate 

Number of calls 6,755 
Average time per call (msec . ) 0.5 
% of total CPU 0.6 
Calls requiring loop on tty_buf lock 
average- time spent looping on lock 
Number of allocation failures 



free total 

5,894 12,649 
0.5 0.5 
0.5 1.0 
0 (0.00% of total) 
No data. msec. (0.00% of total CPU) 
0 (0.00% of attempts) 



CHANNEL LOCK CONTENTION 



Number of calls to tty_lock 
Times channel lock found locked 
Average time spent waiting for lock 
Maximum time spent waiting for lock 



12,963 

554 (4% of attempts) 
7,93 msec. 
3675.17 msec. 



MCS Metering 



F86 Page 7-6 



Interrupts queued because channel locked 



553 (8.5% of interrupts) 



ECHO NEGOTIATION 



for ViApo v bfr&C$ 



Average time of transaction 
Chars, echoed by supervisor 
Chars, echoed by FNPs 



ABNORMAL EVENTS 

Input restarts 
Output restarts 

C Output space overflows 
"needs_space" calls 



1.7 msec. 

389 ( 7.72% of input chars) 0 p 
353 ( 7.00% of input chars)^ p***^ f&2K 

0 (0.00% of read calls) 
0 (0.00% of write calls) 
0 (0.00% of write calls) 
0 



0 o^^T 
6 ^ P<?v Qt 



3t - 



7 
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channel comm meters 



Total metering time 78:15:27 



FNP has been up for 78:15:25 

Number of channels configured 73 

Average number dialed up 54.2 

FNP idle 67.0% . 

Idle at peak load 0.0% *v\ & { mA."* 1 * 

Input Output 

Characters transmitted 7,941,871 38,672,473 

Characters per second 28 137 




Abnormal DIA status 0 ( p 

Memory EDAC errors 0 - n?T On %)j£Te+\l 1/ 

Memory size 64K 
Total available buffer pool 17,888 words » 

Avg. amount of free space 2,448 words auk«6^c, 

Average % of buffer pool available -13.7 
Number of buffer allocations 3,245,838 

Number of buffers preallocated 900,660 ( 27.8% of allocations) 
Used preallocated buffer 900,656 
No preallocated buffer available 126 t r 
Buffer allocation failures 0 - w'cVlfis 

Output restricted by space 0 

Number of interrupts from this FNP 1,996,459 
Avg. time/ interrupt (ms) 3.3 
% of total CPU time 2.3 

Mailbox transactions: 

Input data 756,349 

Output data 557,909 

Input control 563,976 

Output control 122,001 

Total 2,000,235 

Average inbound mailboxes in use 0.2 
Average outbound mailboxes in use 1.0 
Maximum outbound mailboxes in use 8 

No outbound mailbox available 56,638 , B , „ -ttW bvf' 

Input rejects 3 -i'^ ^ " 

% of input transactions rejected 0.00 

Total metering time 78 : 15 : 30 5 9 ^ ^ <7 ^ ^ ^ 
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channel comm meters 



a.hOOO 



before conversion 
Total characters input 3,471 
Total characters output 874,287 
Average length of input 5 . 0 

Average length of output 60.9 



after conversion ratio 
3,274 0.94 
1,243,897 1.42 
4.7 
86.6 



Number of calls 
Average time per call (msec . ) 
Average chars, processed per call 
Number of software interrupts 
Average time per interrupt (msec . ) 



read 
690 
3.2 
5.0 

10,891 
1.2 



write 
14,361 
8.6 
60.9 



control total 
98 15,149 
36.6 8.6 



Effective speed (cps) 



input 
0.0 



output 
0.0 



Output overlaps in FNP 2,875 
Average length of DIA request queue 0.5 

Exhaust status 

Software transfer timing error 
Pre -exhaust status 
Bell/quits 

Echo buffer overflows 
Parity errors 

Avg. number of pending status events 
Software status queue overflows 
Hardware status queue overflows 
Input buffer allocation failures 



AS*) *T K."35 **** r J ^ 



6 ^"0 

"7 A f 



<3 \je oj 



3 f S6??wr xy&7uj Qtreisl, 



^"/aolff 



{Suffer, QpIqus^ ^S7a«S 
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a.h006 



channel comm meters 



Messages transmitted 
Minimum message length 
Maximum message length 
Average message length 

Frames dumped: 
Frames retransmitted: 
Receiver reset request: 
Transmitter reset: 
Frame check errors: 
Frame aborts received: 



input output 

226,489 178,924 

2 2 

133 133 

5.19 25.25 

4 

0 

0 
46 
35 



Output overlaps in FNP 37,741 
Average length of DIA request queue 1.5 



Exhaust status 19 

Software transfer timing error 0 

Parity errors 0 

Avg. number of pending status events 1.8 

Software status queue overflows 0 

Hardware status queue overflows 0 

Input buffer allocation failures 0 
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channel consul meters 



a.h008 



Idle time 42.19% 

Input Output 

Blocks NAKed 2 68 

Transmission timeouts 0 8 

NAKs for DIA backlog 68 N/A 

All transmission suspended 0 0 

Blocks transmitted 4,812 7,042 

Records transmitted 43,204 69 

Average records per block 8 = 98 0 . 01 



Duplicate input blocks 




106 




Output reprocessing 




0 




Blocks reprocessed 




0 








input 


output 


Messages transmitted 




4,812 


7,042 


Minimum message length 




8 


8 


Maximum message length 




397 


398 


Average message length 


*B 


344.85 


8.09 



Output overlaps in FNP 1,522 
Average length of DIA request queue 0.5 

Exhaust status 0 
Software transfer timing error 2 
Parity errors 0 

Avg. number of pending status events 0,8 

Software status queue overflows 0 

Hardware status queue overflows 0 

Input buffer allocation failures 0 



MCS Metering 



F86 Page 7-11 



foe 



fyvlck Cox r\ 



channel comm meters -sum 



Total metering time 



78:15:36 



cps 


cpsi 


cpso iotxXsbepQqa 


err 


ABE 


lid 1 1 LP 


user 


i on 


No data. 


No data. 


0 


a 


E 


a hOOO 


Tni f i al i'7pt 

JL 111 UXaX liftCJ. 


A 


No data. 


No data. 


0 


a 




a hOOl 




1 9A 


0.00 


0.11 


0 


a 


E 




Tni t*i fll i ^e»i' 


i on 


0.00 


0.02 


0 


a 




a hOO^ 






No data. 


No data, i t X 


0 


s 




a hOOfi 




? 0 


No data. 


No data, io s 


78 s 


el . UUvO 




k n 
u 


No data. 


No data. 


0 


s 










1.17 17.76 


0 


a 


E 


a nfil 0 


nCUCl 


/. P.A 


0.01 


0.10 


0 


a 


E 


a . nu x x 


Tni f-4 fll *i to*** 
J.J.1X UlaXl^cI 


/, on 


0.09 


3.70 


0 


a 


E 




Tni t"i al t t o v 
lUlLldl x^ife; J. 


f ov 


0.02 


0.29 


0 


a 




ex . ilvX.} 


T«4 ^- 4 al t o v 
XliX Ulall6CI 


fOU 


0.04 


2.24 


0 


a 


E 




Tr> i f-4 al l 7pr 
XLIX LXall^Cl 




0.01 


0.65 


0 


a 


E 






A 
w 


No data. 


No data. 


0 


s 




ct . uuiu 




A 


No data. 


No data. 


0 


s 




a h017 


Tni t~i al i 7pt t/i' 1 A 1 


480 


0.39 


0.03 xX e Qq 


224 


a 


E 


a.h018 


480 


0.18 


2.06 


0 


a 




a.h019 




480 


0.66 11.58 


0 


a 


E 


a h020 


Larmat 

I JC* X» XXI CX w 


480 


0.00 


0.12 


0 


a 








480 


0.14 


9.32 


0 


a 


E 


a.h022 


Initializer 


480 


0.05 


1.34 


0 


a 




a.h023 




0 


No data 


No data, lot p 


130 


s 


a.h025 




480 


0.04 


0.84 


0 


a 


E 


a.h026 


Initializer 


480 


0.08 


0.97 


0 


a 




a.h027 




480 


0.01 


0.45 


0 


a 


E 


a.h028 


Initializer 


480 


0.21 


7.07 


0 


a 


E 


a.h029 


Raich 


480 


0.01 


1.56 


0 


a 




a.h030 




480 


0.03 


1.53 


0 


a 




a.h031 





i: Invalid input messsage 

o: Output message res transmitted 

t: timeout waiting for acknowledge 

x: pre -exhaust status 

X: exhaust status 

s: software transfer timing error 

b : bell/quit 

e: echo buffer overflow 

p: parity error 

Q: software status queue overflow 

q: hardware status queue overflow 

a: input buffer allocation failure 

A: Asynchronous channel 

B: Synchronous channel 

E: Echoplex mode 
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display_f np_idle -k'.$}o°)f* 



%busy 0 10 20 30 40 50 

III!!! 

07/13/84 1545. A 

1546. A 

1547 . A 

1548. A 

1549 . A 

1550. A 

1551. A 

1552. A 

1553. A 



display_fnp_idle -sum 



FNP a idle time from 07/13/84 1545.2 to 1554.2: 81.3% 
Busiest sample interval: 

07/13/84 1546.2 to 1547.2: 76.8% idle A>o«*fl f 
Busiest single sample: 07/13/84 1554.2: 0.0% idle 

r v ) -\o MniA<? \»\% ft/fib (\Vq Tyfitq ( 
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MCS Debugging 



a FNP Problems/Dumps 

I >scl>fnp_crash_notify . ec 
I dump management 
I debug_fnp 
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debug_fnp example 

db_fnp 



what ^ ^*"~ H y olJ-^*^ f U^5 |K5 ( h Aftfi'fSS MS* $0rS 

Dump in >udd>SysAdmin>Homan>fnp . a . 011084 . 1126 , vers ion 6 . 5d P*$p "7^ M( (E. 



why >^ rm ^f»r.n*r _. v ,7 <^ ' r rW/ 

illegal opcode fault at 46355 (util | 6145)^^^£ J? 7^ t/jT / 
utilities: tried to free space already free f "T 

s _ -r,si Jo*s $o»* of Tks jijo *or< A% : . 



map 




Con f % q\j s<? 


sked 


4540 


09/23/82 


intp 


7176 


11/18/82 


Ctrl 


13400 


10/15/82 


dia 


17060 


01/11/83 


melt 


26342 


12/01/82 


hsla 


27250 


07/07/83 


util 


40210 


12/01/82 


trac 


46740 


09/23/82 


bsc 


47400 


09/23/82 


hasp 


54210 


09/23/82 


x25tbs 


56142 


02/01/83 


meters 


66112 


09/23/82 


init 


66304 


09/29/83 



regs \/ til VPS Y/v ? 

ic 046355 (util 1 6145) i*/U^cNo« O^Ter 

aq 137400 000040 

ir 520077 (zero , carry, interrupt inhibit) iW^ftT^ ft$ t sT?r 
xl 077340 (init | 11034) 
x2 004176 

x3 077000 (init | 10474) 
er 777700 

et 776700 H/O KJf^/f ( h^O 

bstat \}of£e\r .OVi^ I 4T Vi'te^ * o L//vj 

571 free f<rf> 0 W Af*-/7 GvR^ ^ e (33L >W tfi/r**) ^9/ SC & w**fs - ? r * f £ * 
12 small space (^.,^5 

LINE INPUT DIA OUTPUT TOTAL / o~j 4 S C 4^ HfHfQ*, I 

a.hOlO 10 0 1 ^ 

a.h015 10 0 1 

a.h021 10 0 1 
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a.hll2 
a.hll4 
a.hll5 



ffyvcf,**^ ^< ***** 



TOTAL 



11 



/bo?'" 



, 

To JeJ'ti 



— print_trace -50 ,3£f^ 

.(662566 op block at 53024 (bsc|3424), type - 060 (clrlcf) 

y 7 662567 op block at 53027 (bsc|3427), type - 037 (retsub) 

662567 op block at 54376 (hasp | 166), type - 061 (tstlcf) 

662570 op block at 54427 (hasp | 217), type = 033 (dumpin) 

662570 op block at 54430 (hasp j 220), type - 056 (tstlcl) 

662571 op block at 54370 (hasp | 160), type = 072 (setimv) 

662572 op block at 54372 (hasp j 162), type - 005 (dcwlst) 

662572 hsla dew processor, tib 122562, list 54373 (hasp 1 163), len 01 5>nJ Jc*- Cc**4*S 
662575 hsla pcw,j £ib 122562., pew 211000 000460 To HS^A, "> 



"662576 op block at 54374 (hasp | 164), type - 036 (calsub) 
662577 hsla interrupt, 3wjt - 362004 (ch=7 dv =2 subch =10 mod=4»<^ %f°$ 
662600 op block at 52476 (bsc|3076) , type ^Trem ^irinm 

662600 op block at 52501 (bsc|3101), type 

662601 op block at 52504 (bsc|3104), type = 061 (tstlcf) 

662601 op block at 52510 (bsc|3110), type - 061 (tstlcf) 

662602 op block at 52514 (bsc|3114), type = 003 (wait) 
662602 hsla status, tib 122562, status 40 0000 404460 

662721 hsla interrupt, 3wjt - 36300 4, ( ch-7^dv^2^^g^l4_aods4) 

662722 hsla status, tib 123512, status 420200 702060 

662723 istat: tib at 123512, t.cur - 16367 (ctrl|2767), status 000407 



on 



662724 op block at 16413 (ctrl|3013) , type 

662724 op block at 16036 (ctrl|2436), type 

662725 op block at 17034 (ctrl | 3434), type 



004 (status) 
036 (calsub) 

005 (dcwlst) 



662725 hsla dew processor, tib 123512, list 17035 (ctrl j 3435) , len 01 

662726 hsla pew, tib 123512, pew 211400 000060 

662727 op block at 17036 (ctrl | 3436), type - 006 (setime) 
662727 hsla interrupt, 3wjt - 363004 (ch-7 dv=2 subch=14 mod-4) 

662731 op block at 17040 (ctrl | 3440), type - 003 (wait) 

662732 hsla status, tib 123512, status 420000 700060 

662732 istat: tib at 123512, t.cur - 17040 (ctrl|3440), status 000047 

662733 op block at 17044 (ctrl | 3444), type = 004 (status) 

662733 op block at 17050 (ctrl | 3450), type - 037 (retsub) 

662734 op block at 16040 (ctrl | 2440), type 

662735 op block at 16042 (ctrl | 2442), type 

662735 op block at 16045 (ctrl j 2445), type 

662736 op block at 16046 (ctrl j 2446), type 
662736 op block at 16051 (ctrl | 2451), type 
662740 new entry in dia i/o queue at 06717 

662740 op block at 16053 (ctrl | 2453), type = 012 (tstflg) 

662741 op block at 16064 (ctrl | 2464), type - 013 (dmpout) 



052 (setcct) 
011 (clrflg) 
017 (sendin) 
076 (setfld) 
014 (signal) 
opcode 113 (brkcon) 



explain . crldt ;d .crldt 

" .crldt" =» date and time of binding 
00640 000000 112155 200407 431126 
explain . crbdt ;d .crbdt 



09/29/83 1746.7 hfe Thu 
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".crbdt" - date and time of bootloading 

00644 000000 112346 660120 236056 01/04/84 1050.2 hfe Wed 
explain . crbuf ;d .crbuf 

" . crbuf" = starting address of buffer area 

00650 066476 
explain .crmem;d .crmem 

" .crmem" = last location of memory 

00651 177777 
explain .crnbf;d .crnbf 



n . crnbf" - number of buffers available 



00652 001073 ' 



explain .criom;d .criom ^ — ffP* o ~, o rf -f 

".criom" - start of iom table ^ ^^___'C^1 c ^off-K> T^o^ <SS>+ ' 

00653 004200 ofcS^l 
explain .cmhs;d .crnhs 

".crnhs" = number of hsla's configured 

00654 000002 
explain .cmls;d .crnls 

".crnls" - number of Isla's configured 

00655 000000 
explain . crcon ; d . crcon 

" . crcon" * console enabled flag 

00656 000000 
explain . crmod; d .crmod 

".crmod" = starting address of module chain . 

00657 004562 ^V^^*^ ^- J{, f l$ tf n^T 0^ r 
explain .crnxa;bufc .crnxa^*^^-^ So cRrvKft C** 7c ***J G /^°° 
" . crnxa" =■ ptr to next available buffer 

67300 vQ67440, V 000040 V 0Q00Q0 000000 000000 007000 007000 000000 7 . 

67310 ooolSoo oooo-eo loooooo 000000 000000 000000 000000 000000 

67330^=^_V_^ ^ A frli'*Z$*— n — ° f ^*^S 

6744^^67540 000040 000000 000000 000000 000000 000000 000000 7' 

67450 ( 000000 000000 000000 000000 000000 000000 000000 000000 

67470 J - 

67540 000000 007240 000000 000000 000000 000000 000000 000000 

67550 000000 000000 000000 000000 000000 000000 000000 000000 

67570 - 

explain . crtra ; d . crtra 

" . crtra" = trace entry enable mask 

00661 317777 
explain .crtrb;d .crtrb 

" .crtrb" = base address of trace table 

00662 174000 
explain . crtrc ; d . crtrc 

".crtrc" = next available location in trace table 

00663 177536 
explain .crreg;d .crreg 

".crreg" = disaster fault register storage location 

00664 040522 
explain . crttb ; d . crttb 
".crttb" = location of tib table 

00665 066316 
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explain .crtte;d .crtte 

" .crtte" = location of end of tib table 

00666 066476 
explain .crdly;d .crdly 

" . crdly" - head of delay table chain 

00667 067142 
explain . crver ;d .crver 

".crver" — mcs version number, 4 chars 
00670 066056 065144 6.5d 
explain .crbrk;d .crbrk 

".crbrk" - addr of breakpoint control table 

00672 000000 
explain . crtsw ;d .crtsw 

".crtsw" — if non-zero, tracing will cease/ ^ jq 

00673 000000^-c^^^ c _^— dv^ v ^ . , , Can r ^^^ 
explain .crnks;d .crnxsjd .crnxs,* 40 >r* ft H 9 of- ftr<> yyoT chli^f ^ ^ 
".crnxs" - next free small block C ♦*« -O'lAPJ' i 

00674 066602 

66602 066674 000056 400112 000000 066616 000004 400112 000000 
66612 066616 000004 400112 000000 066642 000020 400112 000000 
66622 066642 000004 400112 000000 066642 000004 400112 000000 
66632 - 

explain . crnbs ;d .crnbs 

".crnbs" — number of buffers devoted to small space 

00675 000014 
explain . erect ;d .erect 

".erect" « address of first cct descriptor 

00676 067166 
explain . crskd ;d .crskd 

".crskd" = address of scheduler data block 

00677 006442 sked|1702 
explain ,cretb;d , cretb 

".cretb" - list of echo -negotiation bit tables 

00700 066660 
explain . crept ;d .crept 

".crept" — address of cpu page table 

00701 004000 
explain .crpte; d .crpte 

".crpte" — address of variable cpu page table entry 

00702 004177 
explain . crtsz ;d .crtsz 

" .crtsz" - size of trace data buffer 

00703 004000 
explain .crmet;d .crmet 

".crmet" — non-zero if metering enabled 

00704 000001 
explain . crtdt ;d .crtdt 

" .crtdt" - address of tib for t&d executive channel 

00705 133512 
explain .crbtm;d .crbtm 

" . crbtm" — address of time meters for getbuf /f rebuf 

00706 045270 utilj506G 
explain . crnxe ;bufc .crnxe,* -bf 

".crnxe" = next available space in extended memory 
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135440 



136740 000040 A ' 



136740 


137240 


000040 


- * 


137240 


137340 


000040 




137340 


137400 


000040 


• • 


137400 


137540 


000040 


i 


137540 


137700 


000100 




137700 


140000 


000040 


i 


140000 


140100 


000040 





171400 172000 000400 z... 



172000 172400 000400 z.. 



172400 173000 000400 { . . 
173000 173400 000400 {.. 



173400 000000 000400 
explain . crbpe ; d , crbpe 

" .crbpe" = buffer paging window table entry 

00710 004176 

explain . crcpr ;d .crcpr 

".crcpr" — copyright notice 



jouw ujuiuj ujiutu liuujo iiiujo ujujo ourrt. {Kj) ri.x.b 



00770 040111 116103 056040 061071 070061 040040 



INC. 1981 



dumi^Enp . a . 011084 . 1126 

No >*IB available _ , UlJ 

•line a.hll4 T'^ 0h ^ 

d tib 

012207 207304 400002 015334 001116 
377352 000000 000000 000000 000000 
001431 310450 000000 015332 000000 
077400 000000 013463 000013 000000 
000000 000000 000000 000000 000000 



l/g-M24512 
124522 
124532 
124542 
124552 
124562 



123740 
277002 
131740 
000000 
000000 



114340 
000000 
000000 
000000 
000000 



000004 
000001 
000000 
000000 
000000 



000000 000000 077570 124620 124660 



explain t.stat; flags t.stat 
"t.stat" =- holds current line status 

124512 012207 tsfr£s tsfd£r^ tsf^cv tsfdsr 
explain t. fig; flags t.flg . 

"t.flg" - flag word fffas «" «W> 

124513 207304 tf e^cpx^ tf tbec tfcrec tflfec 
explain t . f lg2 ; f iags"TnfIg2~ * c ^ ph * 
"t.flg2" - second word of flags 

124514 400002 tfpfnl tfdild 



tsfcts tsfcji/ 
tfquit tflisn tffdpx 
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explain t. cur; d t. cur ^ OfA'ock P r '** 7 £ ^ ^^ C K 
"t.cur" - current address in control table 

124515 015334 Ctrl J 1734 
explain t.linejd t.line 
"t.line" — 10 bit line number 

124516 001116 

explain t . icp ; d t . icp ; buf c t . icp , * 
"t.icp" - first buffer in input chain 

124517 123740 

123740 134440 000074 155077 153055 173157 173077 157157 057075 \ .<m?k- {o{ ?oo/= 
123750 175075 067157 165075 125167 077165 173165 155077 075077 }=7ou=Uw?u{um?=? 
123760 075077 077057 077077 067077 077077 153153 173173 157167 =??/??7???kk{ {ow 
123770 077155 155153 173077 173173 133173 057057 155153 173177 ?mmk{?{ { [ {//mk{ . 



134440 


142040 


000074 


157177 


177177 


177172 


177177 


165135 


177177 


b .<o... 


. z . .u] . . 


134450 


157177 


177177 


177157 


073173 


177133 


077176 


177133 


055055 


o o; { 


.[?-.[-- 


134460 


077177 


073133 


157077 


073176 


176177 


057177 


177153 


177077 


?.;[o?;~ 




134470 


077073 


177177 


176177 


177177 


133173 


137137 


177177 


077127 


• » • • • • • 


[{__.. ?W 


142040 


114340 


000074 


135177 


073167 


177177 


177165 


177165 


176176 


L'.<l.;w 


. . .u.u — 


142050 


073067 


133057 


157173 


157155 


135133 


133133 


135153 


157065 


;7[/o{om][[[]ko5 


142060 


155177 


177177 


147073 


177175 


177157 


177177 


157133 


157157 


m. . .g; . } 


. o . . o [oo 


142070 


153057 


073177 


155167 


177177 


173057 


077077 


153157 057155 k/; .mw. . 


{/??ko/m 



114340 
114350 
114360 
114370 - 

explain t. ilst;d t. ilst 



000000 000021 133133 153177 173065 165077 125135 155057 
135077 173177 177000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 



..[[k.{5u?U]m/ 



"t.ilst" 
124520 

"t. icpl r 

124521 

explain 

"t.icch* 

124522 

explain 



=• last buffer in input chain 
114340 



- count of buffers in icp chain 
000004 

t.icch;d t.icch 

= address of next input character 
377352 

t.elnk;d t.elnk 

link to tib extension 



"t.elnk" 
124523 000000 
explain t.rcpjd t.rcp 

"t.rcp" - replay chain pointer (share t.elnk) 

124523 000000 

explain t.ocp;d t.ocp ;bufc t.ocp,* 
"t.ocp" - addr of output chain from cs 

124524 000000 

Invalid buffer address: 0 

explain t.ocur; d t.ocur 

"t.ocur" - addr of current output buffer 

124525 000000 
explain t.olst;d t.olst 

"t.olst" - addr of last buffer in output chain 

124526 000000 
explain t . occh ; d t.occh 
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"t.occh** - addr of next output character 

124527 277002 

explain t.ocntjd t.ocnt 

"t.ocnt" = count of buffers in t.ocur 

124530 000000 
explain t.type;d t.type 
"t.type" - line type 

124531 000001 
explain t.time;d t.time 

"t.time" - time at which next timeout will occur 

124532 001431 310450 
explain t.retajd t.reta 

"t.reta" = return address from calsub 

124534 000000 
explain t.dcwa;d t.dcwa 

"t.dcwa" = addr of dew list to 'execute' 

124535 015332 Ctrl | 1732 
explain t.dcwl;d t.dcwl 
"t.dcwl" = length of dew list 

124536 000000 

explain t.echo;d t.echo;d t.echo,* 40 
"t.echo" =» echo buffer address 

124537 131740 

131740 377354 377354 000157 057155 133133 153177 173065 165077 
131750 125135 155057 135077 173177 177157 155135 133133 133135 
131760 153157 065155 177177 177147 073177 175177 157177 177157 
131770 133157 157153 057073 177155 167177 177173 057077 077153 
explain t.dcp;d t.dcp 
"t.dcp" - addr of message chain for cs 

124540 000000 
explain t.dlst ;d t.dlst 

"t.dlst" - last buffer in messge chain for cs 

124541 000000 
explain t.ftsejd t.ftse 

"t.ftse" - first time slot entry in lsla table 

124542 077400 
d t.sfcm 

124542 077400 
explain t.bcntjd t.bcnt 
"t.bcnt" — counting temporary 

124543 000000 
explain t.brkp;d t.brkp 

"t.brkp" => pointer to current break list 

124544 013463 
explain t.pos;d t.pos 

"t.pos" = current carriage position 

124545 000013 
explain t.ecch; d t.ecch 

"t.ecch" - address of current echo char (hsla only) 

124546 000000 
explain t.cntr;d t.cntr 

"t.cntr" = counter for control tables 

124547 000000 

explain t.flg3; flags t.flg3 
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"t.flgS" - third word of flags 

124550 000000 
explain t.dtp;d t.dtp 

"t.dtp" - pointer to delay table for this line 

124551 000000 
explain t.frmcjd t.frmc 
"t.frmc n — framing chars (2 chars) 

124552 000000 
explain t.dcpl ;d t.dcpl 

"t.dcpl" — number of buffers in dcp chain 

124553 000000 
explain t.sclljd t.scll 

"t.scll" - screenline length left, for echo neg. 

124554 000000 
explain t.sncc;d t.sncc 

"t.sncc" - Echo negotiation sync ctr. 

124555 000000 
explain t.entp;d t.entp 

"t.entp" =■ Echo negotiation break table ptr 

124556 000000 
explain t.ifch;d t.ifch 

"t.ifch" - input flow control characters 

124557 000000 
explain t.ofchjd t.ofch 

"t.ofch" - output flow control characters 

124560 000000 
explain t . omct ; d t.omct 

"t.omct" — output message count (for flow control) 

124561 000000 
explain t.itim;d t.itim 

"t.itim" - time of last call to inproc (2 words) 

124562 000000 000000 
explain t.metr; d t.metr 

"t.metr" - address of metering area 

124564 077570 
explain t.abf0;d t.abfO 

"t.abf0 n =» absolute address of first permanent buffer 

124565 124620 
explain t.abfl;d t.abfl 

"t.abfl" - absolute address of first permanent buffer 

124566 124660 
explain sfcm;d sfcm 

Symbol "sfcm" has no explanation. 

124400 002340 077472 077472 000012 077512 000204 105740 103340 

124410 000000 000000 000460 067200 000000 004374 000040 000040 

124420 000040 377347 000000 000012 571626 000004 000000 700660 

124430 000000 700460 000000 700460 000000 000000 000000 000000 

124440 000000 000000 600000 700460 000000 000000 032000 700660 

124450 000000 000000 004000 700460 000000 000000 600000 700460 

124460 000000 000000 012000 700660 000000 000000 

explain sf.hcmjd sf.hcm 

"sf .hem" - addr of hwcm 

124400 002340 

explain sf.nxa;d sf.nxa 
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"sf .nxa" — addr of next available queue entry 

124401 077472 
explain sf.nxp;d sf.nxp 

"sf .nxp" — addr of next queue entry to process 

124402 077472 
explain sf.tly;d sf.tly 

"sf . tly" — tally of status queue 

124403 000012 
explain sf.tib;d sf.tib 

"sf.tib" - addr of tib for this line 

124404 077512 

explain sf. fig; flags sf.flg 
"sf.flg" — flag word 

124405 000204 sffdct sffcoi 
explain sf.ib0;d sf.ibO,* 40 -ch 
"sf.ib0 n - pointer to input buffer 1 

105740 040377 373265 365277 325335 355257 335277 373377 377377 . {5u?U]m/]?{ . . . 
105750 377357 273173 377333 277376 377333 255255 277377 273133 .o; {. [?~. [--?.; [ 
105760 357277 273376 376377 257377 377153 377277 277273 377377 o? ;•—./. .k. ?? ; . . 
105770 376377 377377 333373 137137 377377 277327 335377 000000 ~. ..[{__.. ?W] .. . 
explain sf.ibljd sf.ibl,* 40 -ch 
"sf.ibl" - pointer to input buffer 2 

103340 040273 367377 377377 365377 365376 376273 267333 257157 ;w. . .u.u— ; 7[/o 

103350 173157 155135 333133 333135 153357 265355 377377 377347 {om] [ [ [ ]ko5m. . .g 

103360 273377 375377 357377 377157 133357 157353 257273 377355 ; . } .o. .o[ook/; .m 

103370 167377 377373 257277 277353 357257 355333 333353 000000 w. . {/??ko/m[ [k. . 

explain sf.ob0;bufc sf.obO,* 

"sf .ob0" - pointer to output buffer 1 

Invalid buffer address: 0 

explain sf.obl;bufc sf.obl,* 

"sf .obi" - pointer to output buffer 2 

Invalid buffer address: 0 

explain sf.pcw;d sf.pcw 

"sf .pew" — current pew 2nd word 

124412 000460 
explain sf.cct;d sf.cct 

"sf.cct" - cct addr for this line, if non-zero 

124413 067200 
explain sf.rct;d sf.rct 

"sf . ret" = repeat count for status queue overflows 

124414 000000 
explain sf .hsl;d sf.hsl 

"sf .hsl" = address of hsla table entry for this line 

124415 004374 
explain sf.bsz;d sf.bsz 
"sf.bsz" - max buffer size 

124416 000040 
explain sf.fbs ;d sf.fbs 

"sf.fbs" - buffer size to be used during frame input 

124417 000040 
explain sf.mms;d sf.mms 

"sf .nuns" = maximum synchronous message size 

124420 000040 

explain sf.csz;d sf.csz 
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"sf.csz" - current asynchronous buffer size 

124420 000040 
explain sf.rms;d sf.rms 

"sf .mis" - remaining unallocated message length 

124421 377347 
explain sf.nicjd sf.nic 

"sf.nic" - char, address of next asynchronous input char 

124421 377347 
explain sf .noc;d sf.noc 

"sf .noc" - char address of next asynchronous output char 

124422 000000 
explain sf.cfg; d sf.cfg 
"sf.cfg" =- 2 words for config pew 
124424 571626 000004 

explain sf .waq;d sf.waq 

"sf .waq" - wrap around queue, software status q 

124442 600000 700460 000000 000000 032000 700660 000000 000000 

124452 004000 700460 000000 000000 600000 700460 000000 000000 

124462 012000 700660 000000 000000 024000 700460 000000 000000 

124472 004000 700460 000000 000000 600000 700460 000000 000000 

124502 012000 700660 000000 000000 024000 700460 000000 000000 

explain sf.stajd sf.sta 

"sf.sta" — hardware status q, sicw here 

124426 000000 700660 000000 700460 000000 700460 000000 000000 
124436 000000 000000 000000 000000 
d hwcm 

02340 105747 460057 103340 460075 131754 470000 131754 450000 

02350 672000 124400 000000 000000 124426 420005 443026 010004 

explain h.ric0;d h.ricO 

"h.rieO" - primary receive icw 

02340 105747 460057 

explain h.ricl;d h.ricl 

"h.ricl" - alternate receive icw 

02342 103340 460075 

explain h.sic0;d h.sicO 

"h.sicO 11 - primary send icw 

02344 131754 470000 

explain h.sicl;d h.sicl 

"h.sicl" - alternate send icw 

02346 131754 450000 

explain h.baw; d h.baw 

"h.baw" =» base address word 

02350 672000 
explain h.sfcm;d h.sfcm 

"h.sfcm" =- software comm. region address 

02351 124400 
explain h.mask;d h.mask 
"h.mask" - mask register 

02352 000000 000000 
explain h.aicw; d h.aicw 
"h.aicw" =- active status icw 
02354 124426 420005 
explain h.cnfgjd h.cnfg 
"h.cnfg" - configuration status 
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02356 443026 010004 
explain m.dql ;d m.dql 

"m.dql" — cumulative length of dia request queue 

124570 000000 000035 

explain m,dqu;d m.dqu 

"m.dqu" - updates of m.dql 

124572 000000 000072 

explain m.nst; d m.nst 

"m.nst" - cumulative no. of pending status 

124574 000000 006023 

explain m.nsu;d m.nsu 

"m.nsu" - updates of m.nst 

124576 000000 006220 

explain m.overjd m.over 

"m.over" - output overlaps 

124600 000000 
explain m.par;d m.par 
"m.par" - parity errors 

124601 000000 
explain m.ssqo;d m.ssqo 

"m.ssqo" - software status queue overflows 

124602 000000 
explain m.hsqo ;d m.hsqo 

"m.hsqo" =■ hardware status queue overflows 

124603 000000 
explain m . inaf ; d m . inaf 

"m.inaf" = input allocation failures 

124604 000000 
explain m.cql;d m.cql 

"m.cql" - current length of dia request queue 

124605 000000 

CAJ^J-aXll iU.CAll, u ill, CAU 

"m.exh" - exhaust status 

124606 000000 000000 
explain m.xte ;d m.xte 
"m.xte" - software xte status 
124610 000000 

explain m.prex;d m.prex 
"m.prex" - pre -exhaust status 
124612 000000 000000 
explain m.ebof ;d m.ebof 
"m.ebof" - echo buffer overflows 
124614 000000 000000 
explain m.quit;d m.quit 
"m.quit" - bell-quits 
124616 000000 

q 
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debug_fnp documentation 

Name : debug_fnp, db_fnp 

The debug_fnp command is a debugging aid intended to be used by FNP software 
developers and in FNP dump analysis. The command can be used to patch or 
dump memory in a running FNP, to examine a dump from a crashed FNP or a core 
image segment before it is loaded, to set breakpoints in a running FNP, 
symbolically display FNP control blocks, buffers, etc. 

Usage 

debug_fnp { initial_command_line } 

where initial_command_line is the first command(s) debug_fnp is to execute. 
Once the initial command(s) , if any, are completed, debug_fnp reads command 
lines from user_input. Each line may contain multiple commands, seperated by 
semi -colons. If an error occurs in any command, the remainder of the 
commands on that line will not be executed. Any debug_fnp command can be 
aborted by issuing a "Quit'* followed by a Multics "program_interrupt" 
command. 

Selecting debug fnp mode 

The debug_fnp command can be setup to operate on either a running FNP, a dump 
segment, or a core image segment. When first invoked, the command is setup 
to examine the first configured FNP. It is possible to switch betweens 
dumps, core images, and running FNP'S at any time. With few exceptions, most 
debug_fnp commands work the same regardless of whether a running fnp, a dump, 
or a core image is selected. 

To select a running FNP: 

fnp tag 

where "tag" is "a", "b", "c" , or "d". 
To select a core image: 

image path 
To select a dump: 

dump path 

where path is the Multics pathname of a segment containing the dump or the 
core image. Core image segments and dump segments have a different format, 
so these commands are not interchangeable. The pathnames on the dump and 
image commands can also be starnames, providing they match one and only one 
entry in the directory specified. 
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In most cases, it is not necessary to know the path name of the dump to be 
examined, as special commands are provided for selecting dumps. 

To list all the dumps currently in the dump directory: 

dumps 

The default dump direcotry is ">dumps" but this can be changed by: 
dump_dir {path} 

where path is the pathname of the new dump directory. If "path" is omitted, 
the name of the current dump directory will be printed. 

To select the latest dump: 

last_dump 

The next earliest dump can be selected with: 
prev_dump 

The prev_dump command can be used repeatedly as long as there are more dumps. 
To select the next latest dump: 
next_dump 

The next__dump and prev_dump commands can be used to peruse any or all of the 
dumps in the dump directory, going in either direction. 

If dealing with a dump which contains multiple FNP's, such a BOS f dump , the 
following command is used to select which FNP in the dump is examined: 

select_fnp tag 

where tag is "a", "b", "c", or "d". 

To find out what FNP, dump, or core image is selected: 
what 

will print the fnp tag, or the pathname. 
Expressions 

Many of the following commands take numeric arguments such as addresses, 
lengths, etc. Any of these arguments can be expressed as a generalized FNP 
expression. Expressions can be arbitrarily complex, containing "(", ")" , 
"+", "-"i "*", and "/" with their normal meanings and precedence. The symbol 
"I" is synnonomous with , as in module j offset. Indirection can be 
specified by following the address to indirect thru. Numeric constants 

are interpreted as octal , unless they are followed by a " . " , in which case 
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they are decimal. The symbol "*" can be used for the current location 
counter, which is generally the last address used in a diaplay or patch 
command. Many common FNP symbols can also be used, including all fields in 
the system comm region, the hardware comm region, the software comm region, 
and the TIB. (Note: before TIB, hwcm, and sfcm addresses can be used, the 
addresses of these control blocks must be established. See the "line" and 
"set" commands). A symbol may also be any opblock mnemmonic, the name of any 
FNP object module, or a machine instruction (specified by surrounding the 
instruction by apostrophes). In additon, user symbols can be defined. 
Examples of expressions: 

hsiaj500 

t.icp,* 

*+30 

tib|14,*+10 
goto 

'Ida 0,2,b.O' 

cax3 (apostrophe not needed if no operand) 



Displaying FNP memory 

To display the contents of FNP words: 

display address {length} {mode} 
d address {length} {mode} 

where "address" is the starting address, "length" is the number of words, and 
"mode" is the display mode. The symbol "*" will be set to the address 
sepcified. The following display modes can be used: 

octal , oct 
character , ch 
address, addr 
clock, ck 
instruction, inst 
opblock, op 
decimal , dec 
bit 

ebcdic , ebc 

If omitted, the length defaults to 1 unless "address" is a predefined FNP 
symbol, in which case the appropriate length for that symbol will be used. 
Similarly, if the mode is omitted, octal is used, unless "address" is a 
predefined FNP symbol in which case the mode appropriate for that symbol is 
used = 

To display a buffer: 

buffer {address} {mode} { -brief | -bf } 
buf {address} {mode} {-brief J -bf } 

where "address" is the address of the buffer, "mode" is the mode to display 
It in (see display command) , and -brief means display only the first 2 words 



(In form module | offset) 
(4 FNP words as a Multics clock) 
(355 instruction format) 
(pseudo opblock format) 
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of the buffer. If "address" is omitted, the next buffer pointer from the 
previous buffer displayed is used. If "mode" is ommitted, character mode is 
assumed. If -breif is not specified, the entrie buffer is displayed, the 
length is determined automatically by reading the buffer header. 

To display a buffer chain: 

buffer_chain {address} {mode} { -brief | -bf } 
bufc {address} {mode} { -brief] -bf} 

If the data being displayed is in the form of threaded control blocks, the 
following commands can be used: 

block {address} {-offset) -o offset} {-length) -1 length} 
blk {address} {-offset|-o offset} {-length|-l length} 

will display a control block at the address specified. The length of the 
block is specified with -length. The default is 8 words. The offset to the 
forward pointer in the block is specified with -offset. The default is 0. 
If the address is not specified, the next block in the chain will be 
displayed (using the forward pointer from the previous block) . 

To display the entire chain of control blocks: 

block_chain {address} {- offset |-o offset} { -length | -1 length} 
bike {address} { -offset | -o offset} { - length | - 1 length} 

will display control blocks until one with a zero forward pointer is 
encountered . 

where the arguments are the same as in the buffer command. This command will 
follow the threads in the buffer chain, displaying each buffer. 

If the data being displayed is a word of flags , the flags command can be used 
to show the setting of individual bits. 

flags address {type} 

where address is the the address of the word containing flags, and the type 
can be: 

t.stat tib status word 

t.flg first tib flag word 

t.flg2 second tib flag word 

sf.flg hsla sfcm flags 

istat interpreter status word 

hs.l first word of hsla hardware status 

hs.2 second word of hsla hardware status 

If {type} is ommitted, it is assumed to be the same as "address", which then 
must be one of the items in the above list. The flags are listed by name, as 
they appear in the macros .map355 source file. The explain command (see other 
commands) can be used to help with unfamiliar names. Occasionally, the value 
of a flag word is known (from a trace, for example), without knowing an 
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address of it. In this case, the following form can be used: 

flags -expression type 

where expression is any valid expression, and type is one of the types shown 
above . 

Patching FNP Memory 

To patch the contents of FNP memory: 

patch address argl . . . {argn} 

where address is the starting address to patch, are the argi represent patch 
data. Each argi may be an expression representing the value to be stored in 
1 FNP word, or a character string in quotes (which may contain more that 1 
word of data) . The total number of words patched cannot exceed 32 . Before 
the patch is applied, the effects of the patch are displayed (old and new 
contents of every word) and the user is asked to verify that the patch is 
correct. The symbol "* n will be set to the address specified. Examples of 
patch commands: 

patch 43102 203456 -1 2 

patch .crver n 3.1x" 

patch Ctrl j 1400 goto ctrl|1600 

patch hsla|1541 'tze 13' cax3 'Ida 0,2,b.l' 

A shorthand form of this command is: 

=argl . . . {argn} 
which is equivilent to: 

patch * argl . . . {argn} 

Individual flag bits in words of flags can be manipulated with the following 
commands : 

set_f lag flag_symbol 

will set the bit associated with the flag_symbol specified in the appropriate 
word. In a similiar way, 

clear_flag flag_symbol 

will clear an individual bit. Currently, these commands are not indivisible 
operations: this means if other flags bits in the word are dynamically 
changing, these command may change their value if they happen to have been 
changed between the time the word was read and when it was rewritten. 

Dump Analysys Commands 
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The following commands are only valid when using debug_fnp on a dump. 
To find out the cause of a dump: 

why- 
will print the type of fault which caused the crash, and if the crash was 
caused by a "die" opcode in the FNP, will interpret the reason for the 
crash . 

The command: 

regs 

will print the contents of all machine registers at the time of the fault. 

If the fault occured in a subroutine (as defined by the map355 'subr' macro), 
information about the call is available with: 

call_trace address {-longj-lg} 

This command will start at the address specified and perform a backwards 
trace of all subroutine calls. If -long is specified, the registers saved at 
each subroutine level will also be printed. This command can also be used on 
a running FNP, but the infromation is probably changing too fast for the 
command to be useful. 



FNP Trace Tables 

A running FNP or a dump will contain a trace table of the most recent events 
oc curing in the FNP. The trace table can be displayed with: 

print_trace { start } 

pr int_trace { start } { count } 

where start indicates the starting trace message and count is the number of 
messages to display. If no arguments are given, the entire trace table is 
printed. If no count is given, the trace tables Is displayed from the 
starting point specified to the end. If the start number is positive it is 
counted from the oldest message; if negative, it is counted from the most 
recent. For example: 

print_trace 200. 
will skip the 199 oldest entries and print. the rest. 

print_trace -50. 
will print the 50 most recent messages. 

Printing the trace table of a running FNP is only meaningful if tracing has 
been suspended; otherwise the table is changing too fast to be interpreted. 
Tracing can be suspendend in a running FNP by: 
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stop_trace 
and restarted with: 

start_trace 

Tracing can also be stopped and started with some of the breakpoint commands 
explained below. 

Which modules in the FNP are traced is determined by the trace mask, kept in 
FNP memory. This mask may be examined or updated with: 

tracejmask {modules} 

If used with no arguments, tracejnask will display and interpret the current 
trace mask. If modules are given, they represent modules to be added to or 
deleted from the current mask. The module should be specified as 'name' or 
'+name' to set the tracing bit for the module; it should be '-name' or 
' A name' to turn off the corresponding bit. In addition, all and none may be 
specified. For example: 

trace_mask hsla A dia -Is la 

will turn on tracing for hsla_man and turn off traceing for dia_man and 
Is la man. 



FNP Breakpoint facility 

The control table interpreter in the FNP allows breakpoints to be set in the 
interpreted control tables. A breakpoint will cause the line encountering it 
to stop execution in the interpreter until a command is given to restart it. 

Breakpoints are often a useful tool but a certain amount of care must be 
excercised in their use. The following points are important: 

1. Breakpoints can only be set in interpreted opblocks. They cannot be set 
at machine instructions. 

2. While at a break, the line is executing an opblock equivilent to: 

wait 0,0,0 

followed by no status blocks. This means that timers can runout unnoticed, 
status will be ignored, hangups can be missed, etc. For this reason, it may 
be difficult to restart a channel after a breakpoint. 

3. Breakpoints cannot be set at subroutine levels where waits would be 
illegal. 

4. Breakpoints cannot be set when a restart may execute a waitm opblock. 

5. Breakpoints cannot be set at a status opblock. 
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6. If a breakpoint is set at a wait opblock, it must be reset before the 

line is restarted. In addition, a breakpoint may not be set at a wait if any 
channels are currently waiting at that block. 

7. Control tables that use local internal variables (as opposed to variables 

in the TIB extension) cannot depend of these variables being preserved during 
the break unless other channels that may use the same control tables are not 
running . 

8. No notice is given when a channel encounters a breakpoint. The 
list_break command will list all breakpoints and show what channels are 
stopped at each one. 

To set a breakpoint: 

set_break address -line- { -stop_trace} 
sb addr e s s - 1 ine - { - s top_trace } 

will set a breakpoint at the address specified. If a tty channel is given, 
the breakpoint will apply to that line only. Any other channel encountering 
the breakpoint will continue execution. If -stop_ trace is specified, the FNP 
will automatically suspend tracing if any channel stops at that breakpoint. 

To reset a break: 

reset_break address 
reset_break -all 
rb address 
rb -all 

will reset a break at the address specified. Any lines stopped at the break 
are not automatically restarted. If -all is specified, all breaks will be 
reset. 

To start a channel stopped at a breakpoint, 

start line {address} {-reset} { -star t_tr ace} 
start -all 

sr line {address} {-reset} { -start_trace} 
sr -all 

will restart the line specified. If an address is given, the line will be 
restarted at the address given, instead of where it was stopped. If -reset 
is specified, the break will be reset before the line is started. If 
-start_trace is specified, tracing will resume as the line is restarted. If 
-all is specified, all lines at breakpoints at the time the command is issued 
will be restarted. 

To list fnp breakpoints: 

list_break 
lb 
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will list all FNP breakpoints and the channels stopped at each. 



Peformance Analysis Commands 

The FNP software periodically samples the instruction counter to determine 
whether the FNP is running or idling. This meter can be displayed with the 
fnp_idle command, as follows: 

idle_time { -reset j -rs) 

will print the percent of time the FNP has been idling since bootload, or the 
last time the command was invoked with the -reset control argument. 

The sampling interval used by the FNP for metering this data can be printed or 
set with the following command: 

sample_time { new_time } 

where new_time, if specified, is the new sampling interval in milliseconds. 
The argument must be between 1 and 1000. If no argument is given, the current 
sampling interval is printed. The default sampling time when the FNP is 
booted is 50 milliseconds. 

More detailed information on FNP usage can be collected by configuring the 
module ' ic_sampler ' in the FNP core image. This module will periodically 
sample the instruction counter (at the rate set by the s amp le_ time command) 
and add 1 to a bucket which represents a small range (typically 16) of FNP 
addresses. With this data it can be determined with some precision where the 
FNP is spending its time when it is running. 

This instruction counter sampling feature is controlled by the ic sample 
command, whih is only accepted if the ic_sampler module is configured in the 
FNP. The following options of the command are used to control ic sampling: 

ic_sample start 

starts the ic sampling feature. Sampling is normally disabled when the FNP is 
booted. 

ic_s ample stop 
stops ic_sampling. 

ic_sample reset 
zeroes all the sampling buckets . 

The following options are used to display the information collected: 
ic_sample module 

prints a table showing each module in the core image and what percentage of 
samples collected occur in that module. 
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ic_sample histogram | hist {fraction} 

prints a histogram showing each bucket address that has data, and the percent 
of non-idle time that bucket represents. The fraction argument, if specified 
must be a floating point number between 0.0 and 1.0. If this option is used, 
the histogram will only contain the most frequently used buckets . Enough 
buckets will be printed so that fraction specified of the total data collected 
will be printed. For example, if the fraction is .9, 10% of the data 
collected will not be display by discarding infrequently ref errenced buckets . 
This option is useful in deleting w noise M from the histogram . 



Other commands 



To select a specfic tty line: 



line {line} 



will locate the TIB, software comm region, and hardware comm region of the 
line specified. Once these addresses are set, fields in these control blocks 
can be referenced by name in any expression in other commands. The line can 
be specified either in Multics form (a.h012) or as an FNP line number 
(1014) . If no line is specified, the name of the current line is printed. 
If the line selected is not on the current FNP, the proper FNP will be 
selected automatically. 



To print a summary of FNP buffer usage: 

buf f er_s tatus { -brief | -bf } 
bstat { -brief j-bf} 

will print a table showing each line and how much buffer space in the FNP it 
is using. If -brief is used, only summary information is printed. 



To set a symbol: 



set symbol value 



where symbol is '*' , 'tib', 'hwcm' , 'sfcm', or any user defined symbol. 
Setting control block addresses (tib, hwcm, sfcm) is more easily done with 
the line command, but can be manually done with the set command in case 
internal FNP tables have been damaged. Note that setting any of these 
control block addresses has no effect on the current value of other control 
blocks. Setting w * n is also done by any dump or patch command. Once set, a 
symbol may be used in any expression in any other command. 



To display a list of modules in the core image: 



map 



will display a list of modules and their addresses. 



To interpret an FNP address: 
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convert_address {addressl} . . . {addressn} 
cva {addressl} . . . {addressn} 

will convert the address to any other meaningful form that can be derived. 
For example, octal values will be converted to module j offset , and vice 
versa. 

To find the explaination of any FNP symbol (usally the output of a flags or 
convert_address command) : 

explain syml {sym2} ... {symn} 

where symi are symbols to be explained. This command will print the comment 
form the line in macros .map355 that defined the symbol. 

To execute any Multics command: 

e Command Line 
will pass 'Command Line' to the command processer. 
To exit from debug_fnp, 

quit 

q 
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a Multics Problems /Dumps 
I tty_analyze 
I tty_dump 
I trace_mcs 
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tty_dump 



LCTE at 13100, channel c.h212, devx 257 
channel type : tty (0) 
flags: in_use initialized 

physical channel devx 257, major channel devx 165, subchannel 72 
input_words 16, output_words 0 
data base at 71124 

WTCB at 71124, channel c.h212, devx 257 
line type - ASCII, baud rate - 2400 

flags : listen, dialed, send_output , tcb_initialized,breakall 

hevent - 000464004602 407777000311, event - 007777000001 400000000002 

fblock - 201512, lb lock - 201512, fchar - 0 

at line 0, column 0, white_col - 0 

0 read-ahead messages 

write_first - 0, write_last — 0 

maximum buffer size - 16, buffer pad - 0 

line delimiter - " 



TCB at 55010 

terminal type — , old type — 0 

modes : rawi , rawo , f ulldpx , c tl_char , breakall , can_type=over s tr ike 

flags : uproc_attached 

shift state - 00 (none) 11-0, pi - 0 

answerback id =» none 

erase #, kill @ s frame_begin \000, frame_end \000 

input message size 0 characters 

input_translation 0 

output_translation 0 

input_conversion 0 

output_conversion 0 

special 0 

delay 0 

read 

201512 size = 16, tally = 49, flags: 

000000000061 123145164164 151156147040 124145155160 ...lSetting Temp 
157162141162 171040160157 151156164145 162163040146 orary pointers f 

162157155040 067063174062 064060056015 012015012141 rom 73 | 240 .a 

172155072040 040000000000 000000000000 000000000000 zm: 
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tty_dump 



LCTE at 10000, channel c.h016, devx 175 
channel type: x25 (11) 
flags: in_use initialized 

physical channel devx 175, major channel devx 165, subchannel 10 
input_words 0, output_words 0 
data base at 127752 

X.25 devx 175, 32 lc, 33 sc, ACTIVE flags: started send_output no_d 
packet_threshold=129 address-56 



LCTE at 41200, channel c.h016.001, devx 1021 
channel type: tty (0) 
flags: in_u.se initialized 

physical channel devx 1021, major channel devx 175, subchannel 1 
input_words 0, output_words 0 
data base at 131350 

WTCB at 131350, channel c.h016.001, devx 1021 
line type =- ASCII, baud rate - 4800 

flags : listen, dialed, send_output , qenable , tcb_initialized,hndlquit , count_lines 

hevent =» 000464013026 407777000721, event - 007777000001 400000000001 

process blocked on input 

fblock - 0, lb lock - 0, fchar - 0 

at line 7, column 0, white_col = 0 

0 read- ahead messages 

write_first = 0, write_last = 0 

maximum buffer size - 16 , buffer pad = 5 

line delimiter - 11 



TC3 at 150604 

terminal type - VIP7205, old type = 7 

modes : can, esc , erkl, If echo ,hndlquit, echoplex, polite , scroll , can_type=replace 
flags : uproc_attached 

shift state - 00 (none) 11 = 80, pi - 23 
answerback id = 3106 

erase #, kill @, frame_begin \000, frame_end \000 
input message size 0 characters 
input_translation 0 
output_translation 0 
input_conversion 60 
output_conversion 170 
special 344 
delay 0 



it 
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tty analyze USiVS ntf^ici S/J^^ ^^^Lvi 
Begin analysis of ERF 66 ^ p/v£ D^^P- 

Header Values: , .^y Yf^ T w * fT V' 

bleft 6366, free 61212 1 ^ * 0 - J TL S.yi 7 P** 

Physical channel c.h016, 4800 baud, devx 175, pcb 65460, lcte 10000, line type X25LAP 
flags: listen dialed send_output sync_line 

multiplexer type: x25 

X.25 devx 175, 32 lc, 33 sc, ACTIVE flags: started send_output no_d 

packet_threshold=129 address=-56 
X.25 SC 1 c.h016.001 devx 1021: DIALED output_ready wru echoplex hndlquit polite Ifech 
LC 16: state=p41(FL0W CONTROL READY) ,max_packet_s ize=12 8 , window used=0/2 
iti baud=4800 
address=31063050005411 



Subchannel: c.h016.001, devx 1021 
wtcb at 131350 

flags : listen, dialed , send_output , qenable , hndlquit , count_lines , scroll 
blocked for input 



Physical channel c„h212, 2400 baud, devx 257, pcb 66300, lcte 13100, line type ASCII 
flags : listen dialed send_output 
wtcb at 71124 

flags : listen, dialed, send_output ,breakall 

Read chain trace 

FBL0CK 

201512 size - 16, tally = 49, flags: 

000000000061 123145164164 151156147040 124145155160 157162141162 171040160157 15115616 
162157155040 067063174062 064060056015 012015012141 172155072040 040000000000 00000000 



Begin free chain trace 
61212 (2 words) 
61474 (16 words) 
62016 (6 words) 
62122 (2 words) 



202732 (140 words) 
203312 (10466 words) 

Begin unthreaded space check 
154702 (40 words) 
157276 (14402 words) 
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trace_mcs ts 100 — w< " 
r 08:22 0.199 94 



trace_mcs modes all 

New MCS trace modes: on, "default, read, write , data, control , modes , interrupt , 
init_mpx , s tart_mpx , s top_mpx , space_man 
r 08:23 0.199 89 

trace_mcs channel ** -on 
r 08:24 0.435 91 

trace__mcs print Sl 

08:24:55.331876 a.h214: int: proc accept_input 024130024130000007604103 

08:24:55.334231 a.h214: 16 words at 024130; 7 chars; flags: 

08:24:55.336228 a.h214: 0: 000000000007 003144020000 d. . 

08:24:55.337438 a.h214: 8: 010161215000 000000000000 .q 

08:24:55.339879 a.h214.001: int: proc accept_input 024130024130000002404103 

08:24:55.342078 a.h214.001: 16 words at 024130; 2 chars; flags: break 

08:24:55.345253 a.h214.001: 8: 010161215000 000000000000 .q 

08:24:55.348781 a.h214: write: 216 | 41214: 6 bytes 

08:24:55.349907 a.h214: 16 words at 041214; 6 chars; flags: break 

08:24:55.353048 a.h214: 8: 240412000000 000000000000 

08:24:55.390663 a.h214.001: control: resetjmore 77777 |1 

08:24:55.398741 a.h214.001: write: 216 | 24130: 19 bytes 

08:24:55.400093 a.h214.001: 16 words at 024130; 19 chars; flags: break 

08:24:55.403383 a.h214.001: 8: 072062064040 060056063071 :24 0.39 

08:24:55.404609 a.h214.001: 16: 060040070015 012015012000 0 8 

08:24:55.408170 a.h214.001: int: queued send_output 000000000000000000000000 

08:24:55.411969 a.h214.001: int: proc queued send_output 000000000000000000000 

08:24:55.423650 a.h214: int: proc send_output 000000000000000000000000 

08:24:55.426293 a.h214: write: 216 | 24130: 24 bytes 

08:24:55.427510 a.h214: 16 words at 024130: 24 chars; flags: break 

08:24:55.430770 a.h214: 8: 242162240060 270072262264 .r.0.:.. 

08:24:55.431998 a.h214: 16: 240060056063 071060240270 .0.390.. 

08:24:55.433199 a.h214: 24: 215012215412 000000000000 

08:24:55.629519 a.h214: int: proc accept_input 024130024130000005604103 

08:24:55.631780 a.h214: 16 words at 024130; 5 chars; flags: 

08:24:55.633764 a.h214: 0: 000000000005 003206020000 

08:24:55.634967 a.h214: 8: 041000000000 000000000000 ! 

08:24:55.645811 a.h214: int: proc send_output 000000000000000000000000 

08:24:55.786612 a.h214: int: proc accept_input 024130024130000005604103 

08:24:55.788824 a.h214: 16 words at 024130; 5 chars; flags: 

08:24:55.790779 a.h214: 0: 000000000005 003250020000 

08:24:55.791978 a.h214: 8: 101000000000 000000000000 A 

08:24:55.969268 a.h027: int: proc accept_input 024130024130000011404103 

08:24:55.971547 a.h027: 16 words at 024130; 9 chars; flags: 

08:24:55.973504 a.h027: 0: 000000000011 156145167137 new_ 

08:24:55.974704 a.h027: 8: 160162157143 012000000000 proc 

08:24:55.987471 a.h027: control: set_required_access_class 366 | 5160 

08:24:56.002503 a.h027: write: 216 | 24130: 60 bytes etc. 

08:24:56.003797 a.h027: 16 words at 024130; 60 chars; flags: 

08:24:56.007063 a.h027: 8: 040144151163 143157156156 disconn 

08:24:56.008293 a.h027: 16: 145143164145 144040160162 ected pr 

08:24:56.009492 a.h027: 24: 157143145163 163040167151 ocess wi 
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08:24:56.010691 a.h027: 

08:24:56.011892 a.h027: 

08:24:56.013123 a.h027: 

08:24:56.014348 a.h027: 

08:24:56.015472 a.h027: 

08:24:56.018778 a.h027: 

08:24:56.020008 a.h027: 

08:24:56.059137 a.h027: 

08:24:56.169153 a.hOOO: 

08:24:56.170605 a.hOOO: 

08:24:56.172639 a.hOOO: 

08:24:56.173865 a.hOOO: 

08:24:56.175127 a.hOOO: 

08:24:56.176354 a.hOOO: 

08:24:56.177579 a.hOOO: 

08:24:56.178779 a.hOOO: 

08:24:56.179977 a.hOOO: 

08:24:56.181180 a.hOOO: 

08:24:56.182305 a.hOOO: 

08:24:56.238164 a.hOOO: 

08:24:56.823444 a.h027: 

08:24:56.826460 a.h027: 

08:24:58.363862 a.h006: 

08:24:58.366380 a.h006: 

08:24:58.368450 a.h006: 

08:24:58.369678 a.h006: 

08:24:58.370917 a.h006: 

08:24:58.372126 a.h006; 

08:24:58.374735 a.h006. 

08:24:58.376945 a.h006, 

08:24:58.380116 a.h006, 

08:24:58.381505 a.h006. 

08:24:58.382702 a.h006, 

08:24:58.386288 a.h006: 

08:24:58.387422 a.h006: 

08:24:58.390562 a.h006: 

08:24:58.462541 a.h006: 

08:24:58.533918 a.h027: 
r 08:25 0.929 89 



32: 154154040142 145040143157 11 be co 
40: 156156145143 164145144040 nnected 
48: 164157040164 150151163040 to this 
56: 164145162155 151156141154 terminal 
16 words at 041214; 18 chars; flags: break 

8: 145162040156 145167137160 er new_p 
16: 162157143056 015012000000 roc 

int: proc send_output 000000000000000000000000 

write: 216 | 24130: 60 bytes etc. 
16 words at 024130; 60 chars; flags: 
0: 041214000074 040060070062 ! . .< 082 
8: 064040040141 1630040040 4 as 
16: 103117116116 105103124040 CONNECT 
24: 126111120067 062060065040 VIP7205 
32: 040156157156 145040141056 none a. 
40: 150060062067 040115157162 h027 Mor 
48: 145154154157 056101111130 ello.AIX 

56: 137101124015 012000000000 _AT 

16 words at 041214; 21 chars; flags: break 

int: proc send_output 000000000000000000000000 

checkjnodes: 230 | 1460 

set_mor?s: 230 | 1460 

int: proc accept_input 024130024130000025604103 
16 words at 024130; 21 chars; flags: 

0: 000000000025 003106020000 F. . 

8: 346164162141 143145137155 . trace_m 
16: 143163040160 162151156164 cs print 

24: 015000000000 000000000000 

001: int: proc accept_input 024130024130000020404103 
001: 16 words at 024130; 16 chars; flags: break 
001: 8: 145137155143 163040160162 e_mcs pr 
001: 16: 151156164012 162151156164 int.rint 

001: 24: 015000000000 000000000000 

write: 216 j 41214: 6 bytes 
16 words at 041214; 6 chars; flags: break 

8: 216412000000 000000000000 

int: proc send_output 000000000000000000000000 
control: copy_meters 77777 |1 
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10 March 82: trace_mcs 

Function: Controls the MCS tracing facility and prints MCS trace table 
entries . 

Syntax: trace_mcs print {channel_name(s) } { -control_arguments} 
trace_mcs reset 

trace_mcs modes {new_modes} { -control_arguments} 
trace_mcs channel { channel_name ( s ) } { - control_arguments } 
trace_mcs table_size {new_table_size} { -control_arguments} 

List of keywords: 
print, pr, p 

Prints entries from the trace table, 
reset, rs 

Resets MCS tracing: sets global modes to off , "default, none, sets the 
trace table size to zero, and turns off both channel tracing flags 
for all channels. No additional arguments are allowed, 
modes 

Prints the current global tracing modes, or changes the specified 
modes if a newjmodes argument is present. See "List of modes", below. 

channel , chn 

Prints or changes the tracing flags for a single channel or group of 
channels. At least one of printing or changing must be specified, and 
at least one channe l_name must be specified. 
table_size, ts 

Changes the size of the MCS trace table. The table size may only be 
changed when tracing is disabled, and if a trace table exists, the 
size must be first changed to zero and then to the new value in order 
to change the size to a different nonzero value. If no new table size 
is supplied, the current table size is printed. 

Arguments : 
channe l_name ( s ) 

Up to 20 different channel names may be specified. The channel names 
may be starnames, and all channels which match any of the supplied 
names is selected for the operation. 
new_modes 

Is the new mode string containing the global MCS tracing modes to be 
changed. See "List of modes", below. 
table_size 

Is a decimal integer specifying the number of entries in the MCS 
trace table. Each entry occupies 16 words in tty_buf. The program 
queries if the new trace table size will occupy more than 50 percent 
of the free space in tty_buf, to guard against errors. 

Control arguments (all functions) : 
-erf NNN 
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Takes the MCS trace table from the FDUMP for ERF NNN. If this 
argument is specified, no parameters (modes, channel flags, table 
size) may be changed, although they can be printed. 



Control arguments (print) : 
-reset, -rs 

Resets the last trace entry indicator in trace_mcs. Normally, only 
those entries which have been added to the trace table since the last 
time entries were printed are printed. If -reset is specified, the 
next use of trace_mcs will print all the trace table entries, 
-all, -a 

Prints all trace table entries, but without resetting or changing the 

last entry indicator, 
-last NNN, -It NNN 

Prints the last NNN entries in the trace table, without resetting or 

changing the last entry indicator, 
-reverse, -rev 

Prints the entries in reverse order. This can only be specified if -all 
or -last is also specified, 
{-channel} XXX, { -chn} XXX 

Selects a channel or group of channels for printing. This control 
argument need not be supplied before the channel name, and is 
provided only for compatibility. 



Control argument ds (channel) : 
-print, -pr 

Causes the state of the channel trace flags for the selected channels 
to be printed. If -on or -off is also specified, both the previous 
and new states are printed. 

-on 

Turns on the "trace" flag for the channel (s). If this flag is 
different from the "default" global mode, and the force flag is not 
also set, the channel is traced. If the force flag is set, the 
channel is traced regardless of the state of the "default" mode, 
-off 

Turns off the "trace" flag for the channel (s). Only one of -on and 
-off may be specified. 
- force , - f c 

Sets the "force" flag for the channel. If the force flag is set, the 
channel is traced or not depending only on the state of its "trace" 
fag, and not on the "default" mode. If -force is specified, one of 
-on or -off must also be specified. 



Control arguments (modes): 
-brief, -bf 

Suppresses the printing of the new mdes after the change is applied. 
Normally, the modes now in effect are printed, 
-long, -lg 

Prints the new mode string after the changes are applied (Default) . 
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List of modes: 
on 

Whether tracing is enabled at all. The "on" mode may also be 
represented as " A off", and t,A on n as "off", 
default 

Whether channels are traced by default. Normally, this is off, 
meaning that only channels whose trace flag is set are traced. 

all 

May only be specified as "all", not " A all". This mode is a shorthand 
for setting all the remaining modes (except "none"), used to turn on 
tracing for all MCS events, 
none 

May only be specified as "none", and not as " A none" . This mode is 
shorthand for resetting all the remaining modes. It is usually used 
in combination with some other mode or modes, to trace only those 
specific operations. 

read 

Whether channel_manager$read operations are traced, 
write 

Whether channel_manager$write operations are traced, 
data 

Whether the data in read and write operations is to be recorded in 
the trace table, as well as the events themselves, 
control 

Whether channel_manager$control operations are traced, 
modes 

Whether channel_manager$check_modes , get_modes, and set_modes 
operations are traced. 

interrupt 

Whether channel_manager$ interrupt , interrupt_later , and 
queue d_inter nipt operations are to be traced. 
init_mpx 

Whether to trace priv_channel_manager$init_multiplexer operations. 
start_mpx 

Whether to trace priv_channel_manager$start_multiplexer operations . 
stop_mpx 

Whether to trace priv_channel_manager$stop_multiplexer operations. 
space_man 

Whether to trace calls to tty_space_man requesting non-buffer type 
space. (Apparently not implemented) 

Access required: 

Access to phcs_ is required to print the trace table of the running 
system. Access to the FDUMP is required to access the trace table in an 
FDUMP. Access to hphcs_ is required to change any parameters for the 
running system. 

Notes : 
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The MCS trace table is kept in a circular array, with old entries being 
overwritten by new ones. Each entry contains the time, the device index 
of the associated channel, and a short string identifying the operation. 
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a Typical Problems 
I FNP load fails 
I FNP Crashes 
I FNP Crashes Repeatedly 
I Multiplexer won't load 
I Channel won't dial up 
I Channel dials up but no I/O 
I Frequent quit signals 
I User dials into wrong process 
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segment In: >Ldd> Include contents modified: 11/09/84 0855.8 

entry modified: 06/21/85 1919.3 



/* BEGIN dn355_data.lncl.pll */ 
/* Date Last Modified and Reason 

Created 07/25/74 by R. B. Snyder for new ttydim. 

Modified 06/23/77 by J. Stern to add channel_work_reqd and cwork_couixt 

Modified 08/14/78 by Robert Coren to remove devx_tab and invent PCBs 

Modified 79 May 14 by Art Beattle to add fnp_mem_size 

Modified December 1979 by Robert Coren to add FNP queue lock 

Modified January 1980 by Larry Johnson to increase max number of FNPs to 8 

Modified 02/12/80 by Robert Coren to add dcw_list_array._ptr 

Modified 03/06/80 by Robert Coren to add some metering info 

Modified 12/10/80 by Robert Coren to add get_meters_waiting flag 

Modified 83-12-16 BIM to use a chanid instead of iom/channel fb's. 

Modified 1984-07-26 BIM for paged iom. 



/* LOCKING RULES: A fnp is locked by its LCTE unless its LCTE is uninitialized. 
In that case, the conf iguration_lock must be held. 

if tty_lock$lock_lcte returns io_no_permisslon, then the caller must 

lock$lock_fast the configuration lock and retry the LCTE lock. If 

the lcte is now initialized, too bad. Otherwise, the conflg Lock protects. 

Configuration locking is interesting to init_multiplexer and 
all of fnp t&d and reconfiguration. The guts of the multiplexer 
pay no attention to it. Thus, if the LCTE can be locked, it MUST be 
locked before changing the io_manager_as signed flag. */ 

/* format: style4,delnl,insnl, A ifthendo */ 

del max_no_355s fixed bin int static lnit (8) options (constant) i 

/* max no of 355s we can handle (arbitrary) */ 

del dn355_data$ external fixed bin; 

del infop pointer; 
del fnpp ptr; 

del 1 datanet_info aligned based (infop), 
2 conf igurati.on_lock aligned, 
3 pid bit (36) aligned, 
3 event bit. (36) aligned, 
3 flags aligned, 

4 notifysw bit (1) unaligned, 
4 pad bit (35) aligned, 



2 


no_of_355s fixed bin, 


/* 


no. of FNP's */ 


2 


trace bit (1) aligned, 


/* 


watch events on console */ 


2 


debug_stop bit (1) aligned, 


/ * 


crash on errors */ 


2 


pad (2) bit (36) aligned, 


/* 


to get alignment for dump reading */ 


2 


per_datanet (max_no_355s ) aligned like fnp_info; 


/* 


data per datanet */ 



* . incl 
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del 1 fnp_lnfo aligned based (fnpp), 
2 mbx_pt pointer, 
2 pcb_arr»y_ptr pointer, 
2 dcw_list_array_ptr pointer, 
2 no_of_channels fixed bin, 
2 fnp_id, 

3 fnp_tag char (1) unaligned, 

3 fnp_number fixed bin (9) unsigned unaligned, 

3 padc bit (18) unaligned, 
2 io_chanid char (8) aligned, 
2 io_managar_chx fixed bin (35), 
2 lsla_ldx (0:5) fixed bin aligned, 
2 hsla~idx (0:2) fixed bin aligned, 
2 count fixed bin, 
2 cur_ptr fixed bin, 
2 last_ptr fixed bin, 
2 bleft_355 fixed bin, 
2 flags, 

3 work_reqd bit (1) unaligned, 

3 boot loading bit (1) unaligned, 

3 running bit (1) unaligned, 

3 wired bit (1) unaligned, 

3 dump__patch_in_progress bit (1) unaligned, 

3 level_3_pending bit (1) unaligned, 

3 level_7_pending bit (1) unaligned, 

3 dump_p at eh_d i s ab 1 e d bit (1) unaligned, 

3 t_and_d_.tn_pr ogress bit (1) unaligned, 

3 t_and_d_lev_3_occurred bit (1) unaligned, 

3 t_and_d_lev_7_occurred bit (1) unaligned, 

3 t_and_d_notif y_requested bit (1) unaligned, 

3 t_and_d_as signed bit (1) unaligned, 

3 get_meters_waiting bit (1) unaligned, 

3 padb bit (22) unaligned, 

2 lcte_ptr ptr, 

2 astep ptr, 

2 boot_ev_chan fixed bin (71), 
2 boot_proceas_id bit (36), 
2 version char (A), 

2 fnp_mem_sisse fixed bin (18) unsigned, 

2 queue_lock bit (36) aligned, 

2 dump_patch__lock bit (36), 

2 q_entries_tnade fixed bin (35), 

2 input_re jeet_count fixed bin, 

2 processed_from_q fixed bin (35), 

2 fnp_channel_locked fixed bin (35), 

2 input_data_transactions fixed bin (35), 

2 output_data_transactions fixed bin (35), 

2 lnput_contt-ol_transactions fixed bin (35), 

2 output_control_transactlons fixed bin (35), 

2 cumulative _mbx_in_use fixed bin (35), 

2 max_mbx_in__use fixed bin, 

2 mbx_in_use_updated fixed bin (35), 

2 mbx_unava liable fixed bin (35), 

2 free_slze fixed bin (35), 

2 free_count fixed bin, 



/* structure for each FNP */ 
/* pointer to mailbox NULL if not in config */ 
/* pointer to array of physical channel blocks */ 
/* pointer to array of space reserved for output DCW lists */ 
/* number of channels on this FNP */ 

/* letter identifying FNP */ 
/* sequence number of FNP */ 



'* devx for DIA on lorn */ 

* index into PCB array for lsla lines */ 

* index into PCB array for hsla lines */ 

* number of items in delay queue */ 

* offset in tty_buf of next delay queue element */ 

* offset in tty_buf of last delay queue element */ 
'* number of free buffers in this 355 */ 

* mailbox messages queued up */ 

* currently being bootloaded */ 

* this FNP is running */ 

* bootload buffer is wired */ 

* a dump or patch order is in progress */ 
'* level 3 Interrupt pending */ 

* level 7 Interrupt pending */ 

* dump & patch orders disabled because of timeout */ 

* T & D using FNP */ 

'* A level 3 occurred */ 



* AS has given fnp to process */ 

* waiting for meter copy to complete */ 

* pointer to this FNP's LCT entry */ 

* pointer to aste of wired bootload buffer */ 

* event channel over which to signal bootload completion */ 

* process that initiated bootload */ 

* version id of core image */ 

'* memory size of this FNP in 18-bit words */ 

* lock for interrupt queue */ 

* lock for fnp_dump or _patch operation */ 

* count of delay queue entries made */ 

* number of times input rejected */ 

* number of interrupts processed from queue */ 

* number of times dn355 found per-FNP lock locked */ 

* number of mailbox transactions for input */ 

* number of mailbox transactions for output */ 

* number of mailbox transactions for inbound control info */ 

* number of mailbox transactions for outbound control info */ 
'* cumulative count of number of outbound mailboxes in use */ 

* maximum number of mailboxes in use at any given time */ 

* number of increments to cumulative_mbx_in_use */ 

* number of times had to queue mailbox transaction because none available 
'* cumulative amount of bleft_355 */ 

'* number of adds to above */ 



* . incl 
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f np_space_restricted_output fixed bin (35), 

tanddpcbx fixed bin, 

n_pages_wired fixed bin, 

config_flags aLigned, 

3 available bit (1) unaligned, 

3 io_manager_assigned bit (1) unaligned, 

3 pad bit (34) aligned, 

ptx fixed bin, 

ptp pointer unaligned; 



/* number of times available FNP space restricted amount of output sent */ 
I* index of PCB for COLTS channel */ 
/* pages wired for loading */ 

/* reconfig says "yes" */ 

/* We have channel assigned to us */ 

/* page table index, used only at bootload */ 
/* page table for this FNP */ 



/**** The following named constants are used to lay out the 
lom page tables . Each FNP has to have its own page 
table because there Is not enough room to have eight different 
bootload images of 32 K and > 64 K of tty_buf 

THE MAX TTY BUF LENGTH IS 192 K words. We could have another 16 K 
easily, and then after that it would get hard. */ 



xhe layout 



Page I/O address Memory address 



Comments 



0 xxxxxx Invalid PTW 

2000 2000 write-enabled (mailbox) 

4000 4000 write-enabled (mailbox) 

6000 6000 write-enabled (mailbox) 

10000 as needed bootload image segment page 0 



35 
36 



110000 
112000 



as needed 
xxxxxx 



bootload linage segment page 31 
invalid PTW 



63 
64 



127 
255 



160000 
200000 



260000 



as needed 
as needed 



invalid PTW 

tty_buf page 0 

tty_buf page 63 

tty_buf page 191 



/aa/vkt We assume that the page table starts at all zeros. */ 



declare FIRST_BOOTLOAD_PAGEX fixed bin init (4) int static options (constant) i 
declare FIRST_TTY_BUF_PAGEX fixed bin init (64) int static options (constant) ; 



/* End include file dn355_data.lncl.pll */ 
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let. lncl.pll 



segment In: >ldd> include contents modified: 11/08/82 1005.8 

entry modified: 06/21/85 1917.0 



/* BEGIN INCLUDE FILE ... let. lncl.pll */ 
/* Created by J. Stern 7/26/78 */ 

/* Metering Information added by C. Hornig, March 1980. */ 

/* Unwired saved meters added by Robert Coren, December 1980 */ 



del lctp ptr; /* ptr to logical channel table */ 

del lctep ptr ; /* ptr to logical channel table entry */ 

del lct_slze fixed bin; /* size of lcte_array when allocated */ 



del 1 let aligned based (lctp), 
2 max_no_lctes fixed bin, 
2 cur_no_lctes fixed bin, 
2 lcnt_ptr ptr, 
2 queue_lock bit (36), 
2 pad (11) fixed bin, 

2 lcte_array (lct_size refer (lct.max_no_lctes) ) 



/* logical channel table */ 

/* maximum number of let entries */ 

/* current number of let entries used */ 

/* ptr to logical channel name table */ 

/* lock used to serialize queuelng operations */ 

like Lctej /* let entries */ 



del 1 lcte aligned based (lctep), 
2 lock bit (36), 
2 data_base_ptr ptr unal, 
2 channel_type fixed bin (8) unal, 
2 flags unal, 

3 entry_in_use bit (1) unal, 

3 initialized bit (1) unal, 

3 notify_reqd bit (1) unal, 

3 locked_f or_interrupt bit (1) unal, 

3 space_needed bit (1) unal, 

3 special_lock bit (1) unal, 

3 trace_force bit (1) unal, 

3 trace bit (1) unal, 

3 unused bit (1) unal, 
2 physical_channel_devx fixed bin (17) unal, 
2 major_channel_info, 

3 major_channel_devx fixed bin unal, 

3 subchannel fixed bin (17) unal, 
2 queue_entries , 

3 queue_head bit (18) unal, 

3 queue_tall bit (18) unal, 
2 word_counts, 

3 input_words fixed bin (17) unal, 

3 output_words fixed bin (17) unal, 



* logical channel table entry */ 

* channel lock */ 

* ptr to channel data base */ 

* Identifies channel manager program */ 

* ON if this entry in use */ 

* ON if this channel initialized */ 

* ON if must notify when unlocking this channel */ 

* ON if lock set by Interrupt handler */ 

* ON if this channel needs buffer space */ 

* ON if lock is managed by multiplexer */ 

* ON to trace based on next bit only */ 

* OFF to XOR next bit with tty_buf .default_traclng */ 

* ON to trace this channel */ 

* devx of physical chan from which logical chan is derived */ 

* major channel device index */ 

* subchannel id (or data ptr) wrt major channel */ 

* ptr to first queue entry for this channel */ 

* ptr to last queue entry for this channel */ 

* number of input words charged to this channel */ 

* number of output words charged to this channel */ 



2 meters, 

3 in_bytes fixed bin (35), 
3 out_bytes fixed bin (35), 
3 in, 

it calls fixed bin (35), 



*.incl 
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4 interrupts fined bin (35), 

4 call_time fixed bin (71), 

4 interrupttime fixed bin (71), 
3 out Like Icte .meters . in, 
3 control like lcte .meters . in, 
2 saved_meters_ptr ptr, /* pointer to unwired copy of meters saved at last dialup */ 

2 tlmer_offset bit (18) aligned, /* Head of list of timers for this channel */ 

2 pad (3) fixed bin (35) i 



del lentp ptr i 

del 1 lent aligned based (lentp), 

2 names (lct.max_no lctes) char (32) unali 

del 1 saved_meters aligned based like lcte. meters i 



/* ptx to logical channel name table */ 

/* logical channel name table */ 

/* channel names */ 

/* meters saved at dialup, allocated in tty_area */ 



/* END INCLUDE FILE ... lct.incl.pll */ 
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pcb. Lncl.pll segment in: >ldd> include contents modified: 07/08/81 

entry modified: 06/21/85 1915.3 



/* BEGIN INCLUDE FILE ... pcb. lncl.pll */ 

/* Created 08/14/78 by Robert S. Coren */ 

/* Modified 02/19/80 by Robert S. Coren to add read_flrst & read_iast */ 

/* Modified 12/10/80 by Robert S. Coren to add metering stuff */ 

/* Modified May 1981 by Robert S. Coren to add tandd_attached flag */ 



/* Describes physical channel blocks for FNP channels */ 

del njpebs fixed bint 
del pebp ptrt 

del 1 pcb_array (n_pcbs) based aligned like pebt 

del 1 pcb aligned based (pebp), 
2 channel_desc unaligned, 

3 devx fixed bin (17), 

3 subchan fixed bin (7) unaligned, 

3 llne_number unal, 

4 is_hsla bit (1) unaligned, 
4 la_no bit (3) unaligned, 
4 slot_no bit (6) unaligned, 
2 wrlte_first fixed bin (17) unaligned, 
2 write_last fixed bin (17) unaligned, 
2 baud_rate fixed bin (17) unaligned, 
2 line_type fixed bin (17) unaligned, 
2 max_buf_size fixed bin (17) unaligned, 
2 write_cnt fixed bin (17) unaligned, 
2 flags unaligned, 

3 listen bit (1), 

3 dialed bit (1), 

3 send_output bit (1), 

3 high_speed bit (1), 

3 sync_llne bit (1), 

3 end_frame bit (1), 

3 hndlqult bit (1), 

3 breakall_enabled bit (1), 

3 output_mbx_pending bit (1), 

3 copled_metera_ready bit (1), 

3 get_meters_waiting bit (1), 

3 tanddattached bit (1), 

3 padb bit (24), 
2 read_first fixed bin (18) unsigned unaligned, 
2 read_last fixed bin (18) unsigned unaligned, 
2 saved_meters_ptr pointer unaligned, 
2 copled_meters_off set fixed bin (18) unsigned! 

/* END INCLUDE FILE ... pcb. lncl.pll */ 



/* physical channel block declaration */ 
/* index of LOT entry */ 

/* logical subchannel /is la slot # correspondence */ 

/* regular line number */ 

/* on if hsla, off if lsla */ 

/* line adapter (high or low speed) number */ 

/* physical slot or subchannel number */ 

/* offset of first buffer in output chain */ 

/* offset of last buffer in output chain */ 

/* baud rate of channel */ 

/* line type */ 

/* largest buffer to be allocated for output */ 
/* number of characters in write chain */ 

/* channel is ready for dialup */ 

/* channel is dialed up or connected */ 

/* channel is ready for output */ 

/* needs large send_out threshold */ 

/* synchronous channel */ 

/* channel is waiting for formfeed */ 

/* channel in hndlqult mode */ 

/* breakall mode allowed for this channel */ 

/* A wtx mbx has been sent, but not relinquished */ 

/* copy_meters operation has completed */ 

/* waiting for get_meters operation to complete */ 

/* this channel is in use by T & D */ 

/* head of read chain (while reading from FNP) */ 

/* tail of read chain (likewise) */ 

/* pointer to (unwired) copy of meters at last dialup */ 

/* offset in tty_buf of buffer meters copied to */ 
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tcb, incl.pll 



aegment in» >idd> include contents modified: 06/18/81 0900.8 

entry modified? 06/21/85 1915.2 



/* BEGIN INCLUDE FILE ... tcb. incl.pll */ 



/* Date Last Modified and Reason 

Created 04/19/77 by J. Stern (from part of tty. incl .pll) 

Modified 2/6/78 by Robert Coren to add lnput_msg_size 

Modified A/18/78 by Robert Coren to add f ramingchars 

Modified 8/31/78 by J. Nlcholls to add scroll mode 

Extracted 9/12/78 by J. Stern from tty_data. incl .pll 

Modified Oct. 1979 by Robert Coren to expand to 36 possible modes 

Modified 1/21/80 by Robert Coren to add no_outp, oddp, & eight_bit modes 

Modified 10/08/80 by Robert Coren to add meters for tty_read & tty_write 

Modified: 10 November 1980 by 6. Falter to add can_type and explicit padding 

Modified 12/04/80 by Robert Coren to add saved copy of meters 

Modified 2/24/81 by Robert Coren to add time spent in tty_read and write 

Modified April 1981 by Robert Coren to add time last dialed up 



del tcbp ptrj 

del 1 tcb based (tcbp) aligned, 

2 termlnal_type char (32) unaligned, 

2 tables, 

3 input_mvtrp bit (18) unaligned, 
3 output_mvtrp bit (18) unaligned, 
3 input_tctrp bit (18) unaligned, 
3 output_tctrp bit (18) unaligned, 
3 specialrp bit (18) unaligned, 
3 delayrp bit (18) unaligned, 

2 defauit_tables, 

3 df_input_mvtrp bit (18) unaligned, 
3 df_output_mvtrp bit (18) unaligned, 
3 df_input_tctrp bit (18) unaligned, 
3 df_output_tctrp bit (18) unaligned, 
3 df_specialrp bit (18) unaligned, 
3 df_delayrp bit (18) unaligned, 

2 special_input_chars unaligned, 
3 erase char (1) unaligned, 
3 kill char (1) unaligned, 

2 old_type fixed bin (17) unaligned, 

2 modes unaligned, 

3 edited bit (1) unaligned, 
3 tabm bit (1) unaligned, 
3 canm bit (1) unaligned, 

3 escm bit (1) unaligned, 
3 erklm bit (1) unaligned, 
3 rawim bit (1) unaligned, 



* declaration of per terminal control block */ 

* terminal type name */ 

* rel pointer to current input mvt table */ 

* rel pointer to current output mvt table */ 

* rel pointer to current input tct table */ 

* rel pointer to current output tct table */ 

* rel pointer to current special chars table */ 

* rel pointer to current delay table */ 

* rel pointer to default input mvt table */ 

* rel pointer to default output mvt table */ 

* rel pointer to default input tct table */ 

* rel pointer to default output tct table */ 

* rel pointer to default special chars table */ 

* rel pointer to default delay table */ 

* erase character */ 

* kill character */ 

* old terminal type number */ 

* modes set by order call */ 

* edited output mode */ 

* insert output tabs mode */ 

* do canonical form conversion */ 

* do input escape conversions */ 

* do erase kill processing */ 

* don't convert input */ 
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3 rawom bit (1) unaligned, 
3 redm bit (1) unaligned, 
3 vertsp bit (1) unaligned, 

3 echo_cr bit (1) unaligned, 
3 echo_lf bit (1) unaligned, 
3 echo_tab bit: (1) unaligned, 

3 hndlquit bit (1) unaligned, 
3 full_duplex bit (1) unaligned, 
3 echoplex bit (1) unaligned, 

3 upper_case bit (1) unaligned, 
3 replay bit (1) unaligned, 
3 polite bit (1) unaligned, 

3 control bit (1) unaligned, 
3 blk_xfer bit (1) unaligned, 
3 breakall bit (1) unaligned, 

3 scroll bit (1) unaligned, 
3 prefixnl bit (1) unaligned, 
3 wake_tbl bit (1) unaligned, 

3 iflow bit (1) unaligned, 
3 of low bit (1) unaligned, 
3 no_outp bit (1) unaligned, 

3 elght_bit bit (1) unaligned, 
3 odd_parity bit (1) unaligned, 

3 modes__pad bit (7) unaligned, 

2 id char (4) unaligned, 

2 colmax fixed bin (8) unaligned, 
2 linemax fixed bin (8) unaligned, 
2 wrt_lchar fixed bin (17) unaligned, 

2 input_msg_sizo fixed bin, 
2 f ramlng_chars unaligned, 

3 f rame_beg in char (1) unaligned, 

3 frame_end char (1) unaligned, 
2 max_output_block fixed bin (18) unsigned unaligned, 

2 input_suspend seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3), 
2 input_resume_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3), 

2 output_suspend_etb_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char ( 3 ) , 
2 output_resume_ack_seq unaligned, 



/* don't convert output */ 

/* has red-shift function */ 

/* send real ff's and vt's if on, else escape them */ 

/* echo carriage returns */ 

/* echo line feeds */ 

/* echo tabs */ 

/* cr's on quit */ 

/* xmlt and receive simultaneously */ 

/* echo input characters on terminal */ 

/* map lower-case output into upper-case */ 

/* replay interrupted input */ 

/* output must start at left margin */ 

/* accept control characters */ 

/* block transfer or "frame" mode */ 

/* break on all characters */ 

/* scroll mode for crt terminals */ 

/* prefix output iwth nl when input interrupted */ 

/* input wakeups determined by wakeup table */ 

/* input flow control */ 

/* output flow control */ 

/* don't generate output parity */ 

/* don't strip input parity */ 

/* generate odd parity (if any) */ 



/* terminal id */ 

/* current maximum number of columns */ 

/* current maximum number of lines /frame */ 

/* char within last write block */ 

/* maximum input message size in chars */ 

/* frame-begin character */ 

/* frame-end character */ 

/* maximum size of output block in block_acknowledge */ 

/* sequence for input suspension */ 



/* likewise for input resumption */ 



/* sequence for output suspension or end_o£_block */ 



/* likewise for resumption or ack */ 
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3 count fixed bin (9) unsigned, 
3 chars char (3), 

2 flags unaligned, 

3 breakall_enabled bit (1) unaligned, 
3 dont_count_next bit (1) unaligned, 
3 keyboard_locking bit (1) unaligned, 
3 no_printer_of f bit (1) unaligned, 
3 break_char_pending bit (1) unaligned, 
3 uproc_attached bit (1) unaligned, 
3 block_acknowledge bit (1) unaligned, 
3 £lags_pad bit (27) unaligned, 

2 actshift bit (2) unaligned, 

2 cumulative_me ters , 

3 read_cails fixed bin (35), 

3 wrlte_calls fixed bin (35), 

3 read_chars fixed bin (35), 

3 write_chars fixed bin (35), 

3 read_time fixed bin (71), 

3 write_time fixed bin (71), 
2 saved_meters like tcb . cumulative_meters , 

2 can_type fixed binary (9) unaligned unsigned, 
2 padl bit (27) unaligned, 
2 time_dialed fixed bin (71) s 

END INCLUDE FILE ... tcb.lncl.pll */ 



lncl 



I* tty dim flag bits */ 

/* channel is permitted to use breakall mode */ 

/* next output character is escaped */ 

/* ON if doing keybd locking for ASCII line type */ 

/* reject printer_o£f /printer_on orders */ 

/* break character is in preconverted buffer */ 

/* user process has attached device */ 

/* block acknowledgement output protocol */ 



/* tty shift, 00 none, 01 lower, 10 upper, 11 unknown */ 

/* continuously running meters */ 
/* number of calls to tty_read */ 
/* number of calls to tty_write */ 
/* after conversion */ 
/* before conversion */ 
/* total time spent in tty_read */ 
/* total time spent in ttywrite */ 
/* meters saved at last dialup */ 

/* type of canonical izat ion to use on this channel */ 
/* to word boundary */ 

/* clock time of last copyjneters order */ 



.pll 
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tty_buf . lncl .pll 



segment in: >ldd> include contents modified: 01/06/85 1422.1 

entry modified) 06/21/85 1919.6 



/* BEGIN INCLUDE FILE ... tty_buf . incl.pll */ 

/* Date Last Modified and Reason 

Created OA/19/77 by J. Stern (from part of tty . lncl .pll) 

Modified January 1978 by Robert Coren and Larry Johnson, for variable-size buffers 

Modified 2/6/78 by Robert Coren to make circular_queue size settable 

Modified Aug 78 by J. Nicholls to move the buffer block format to a file of its own 

and wtcb to its own plus other modification for ring 0 multiplexing, tty_buf f er_block. incl .pll 

Modified 7/17/79 by B. Greenberg for echo negotiation meters. 

Modified November 1979 by C. Hornig for MCS tracing. 

Modified December 1979 by Robert Coren to add FNP channel lock meter 

Modified February 1980 by Robert Coren to remove all references to circular buffer 

Modified March 1980 by Robert Coren to reorganize metering information 

Modified December 1980 by Robert Coren to add FNP-speclfic events 

Modified 24 March 1982, W. Olin Sibert, to add mcs_timer support, recoverable_error_severlty 
Modified November 1984 by Robert Coren to add tty_area lock 

*/ 

del ttybp ptr, 

tty_buf$ ext static, /* tty buffer segment */ 

tty_ev fixed bin int static options (constant) init (57), /*. event used for wait and notify */ 

abs_buf_limit fixed bin (18) static options (constant) init (64), /* minimum number of words we will leave free */ 
inputbpart fixed bin (18) static options (constant) init (2), /* fraction of bleft we will allow for input */ 
output_bpart fixed bin (18) static options (constant) init (4)s /* fraction of bleft we will allow for output */ 



del qblocksize fixed bin int static options (constant) init (16); /* size in words of a delay queue block */ 

del bsizec fixed bin int static options (constant) init (60); /* number of characters in smallest buffer */ 

del buf_per_second fixed bin int static options (constant.) init (10); /* for figuring out max. buffer size based on speed */ 

del FNP_DUMP_PATCH_EVENT fixed bin int static options (constant) init (58); 

del FNP_METER_EVENT fixed bin int static options (constant) init (59); 

del TTY_AREA_LOCK_EVENT bit (36) aligned int static options (constant) init ("74"b3); 



1 


tty_buf aligned based (ttybp), 


1* 


declaration of tty buffer seg */ 


2 


slock bit (36), 


/* 


per system lock */ 


2 


absorig fixed bin (24), 


/* 


abs address of this seg */ 


2 


borig bit (18), 


/* 


index of start of buffer area */ 


2 


bleft fixed bin (18), 


/ft 


words left in pool */ 


2 


free bit (18) , 


/* 


pointer to start of free pool */ 


2 


fnp_conf ig_f lags (8) bit (1) unal, 


/* 


flag(i) ON if fnp(i) configured */ 


2 


padbl bit (28) unaligned, 






2 


lct_j>tr ptr, 


/* 


pointer to logical channel table */ 


2 


nrawread fixed bin (35), 


/* 


number of raw chars input, total */ 


2 


nrawwrlte fixed bin (35), 


/* 


number of raw characters output */ 


2 


ninchars fixed bin (35), 


/ft 


total input chars after conversion */ 


2 


noutchars fixed bin (35), 


/ft 


total output chars before conversion */ 


2 


readblocked fixed bin (35), 


/* 


number of times go input blocked */ 


2 


nblocked fixed bin (35), 


/ft 


number of times process output blocked */ 
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2 minbuf fixed bin (18), 
2 totbuf fixed bin (35), 

2 preconverted fixed bin (35), 

2 input_restart fixed bin, 

2 output_restart fixed bin, 

2 output_buffer_overf low fixed bin, 

2 read_time fixed bin (71), 

2 write_time fixed bin (71), 

2 read_calls fixed bin (35), 

2 write_calls fixed bin (35), 

2 bfx fixed bin, 

2 nquits fixed bin (35), 

2 space_needed_data, 

3 space_needed bit (1) unal, 

3 space_needed_calls fixed bin (3A) unal, 
2 space_lock_count fixed bin (35), 
2 space_lock_walt_CQunt fixed bin (35), 
2 space_lock_wa:Lt_time fixed bin (35), 

2 alloc_calls fixed bin (35), 

2 free_calls fixed bin (35), 

2 alloc_time fixed bin (35), 

2 free_tlme fixed bin (35), 

2 total_alloc_ateps fixed bin (35), 

2 alloc_f allures fixed bin (35), 

2 cumulative_input_space fixed bin (71), 

2 cumulative_output_space fixed bin (71), 
2 cumulative_control_space fixed bin (71), 
2 input_space_updates fixed bin (35), 
2 output_space_updates fixed bin (35), 
2 control_space updates fixed bin (35), 
2 minimum_free_space fixed bin (18), 

2 current_input space fixed bin (18), 

2 current_output_space fixed bin (18), 

2 current_control_space fixed bin (18), 

2 tty_lock calls fixed bin (35), 

2 f ound_channe 1 locked fixed bin (35), 

2 max_wait_time fixed bin (35), 

2 total_wait_time fixed bin (71), 

2 echo_neg_time fixed bin (71), 

2 echo_neg_interrupts fixed bin (35), 

2 echo_neg_rO_chars fixed bin (35), 

2 echo_neg_mux_chars fixed bin (35), 

2 echo_neg_sndopt_restarts fixed bin (35), 

2 echo_neg_mux_nonecho fixed bin (35), 

2 echo_neg_entrles fixed bin (35), 

2 echo_neg_mux_;Lnhibit bit (1) aligned, 
2 n_queued_lnterrupts fixed bin (35), 
2 trace unaligned, 
3 flags, 



/* min output buffer size */ 
/* divide by nblocked to get ave buffer size */ 

/* number of converted chars held in tty_buf */ 

/* number of times tty_read had to start over */ 

/* number of times tty_write has had to start over */ 

/* number of times tty_write has run out of buffers */ 

/* total time spent in tty_read */ 

/* total time spent in tty_write */ 

/* number of calls to tty_read */ 
/* number of calls to tty_write */ 
/* used In calls to iobm */ 
/* number of quits */ 

/* space_needed bit on in at least 1 Icte */ 

/* meter of uses of this facility */ 

/* count of times tty_buf .slock locked */ 

/* count of times necessary to loop to lock it */ 

/* total time looped trying to lock it */ 

/* total number of allocations performed In. tty_buf */ 

/* total number of freeings in tty_buf */ 

/* time spent masked in tty_space_man$get entries */ 

/* time spent masked in tty_space_man$free entries */ 

/* number of steps thru free chain while doing above */ 

/* number of unsuccessful attempts to allocate space */ 

/* cumulative amount of space allocated for input */ 

/* cumulative amount of space allocated for output */ 

/* cumulative amount of space allocated by tty_space_man$get_space */ 

/* number of increments to cumulative_input_space */ 

/* number of increments to cumulatlve_output_space */ 

/* number of increments to cumulatlve__control_space */ 

/* smallest amount of free space ever available */ 

/* amount of space currently allocated for input */ 

/* amount of space currently allocated for output */ 

/* amount of space currently allocated by get_space */ 

/* number of calls to tty_lock$lock entries */ 

/* number of times tty_lock found channel already locked */ 

/* longest time waited for any channel lock */ 

/* total amount of time spent waiting for channel locks */ 

/* cumulative time spent doing echo negotiation */ 

/* Echo-negotiated shipments */ 

/* Chars echoed by ring 0 */ 

/* Chars echoed by mux */ 

/* Echo reinits */ 

/* Entries into negotiate */ 

/* For testing */ 

/* number of interrupts queued by tty_lock */ 

/* tracing information */ 
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/* global tracing control */ 

* whether to trace channels by default */ 

* read */ 

* write */ 

* buffers on reads and writes */ 

* control, prlv_control, and hprlv_control */ 

* (get set check)_modes */ 

* Interrupt, interrupt_later */ 

* init_multiplexer, terminatejnultlplexer */ 

* start, stop */ 

* shutdown */ 

* tty_space_man$* */ 

* offset of tracing data */ 



4 enable bit, 
4 default_mode bit, 
4 read bit, 
4 write bit, 
4 data bit, 
4 control bit, 
4 modes bit, 
4 interrupt bit, 
4 Init bit, 
4 start bit, 
4 shutdown bit, 
4 spaceman bit, 
4 pad_flags bit (6), 
3 data_offset bit (18), 

2 recoverable_ei:ror_severity fixed bin, 

2 tlmer_lock bit (36) aligned, 
2 next_tlmer_offset bit (18) aligned, 
2 timer_count fixed bin, 
2 tlmer_process bit (36) aligned, 

2 timer_ev_chn fixed bin (71), 
2 timer_lock_walt_time fixed bin (71), 

2 tiraer_iock_count fixed bin (35), 
2 timer_lock_wait_count fixed bin (35), 
2 tlmer_call_tltrie fixed bin (71), 

2 timer_polling_tlme fixed bin (71), 
2 timer_set_calls fixed bin (35), /* 
2 tlmer_reset_ca.lls fixed bin (35), /* 

2 timer_change_calls fixed bin (35), /* 

2 tlmer_poll_calls fixed bin (35), /* 

2 timer_error_calls fixed bin (35), /* 

2 tlmer_dupllcate_pollings fixed bin (35), /* 

2 tty_area_lock like hc_fast_lock, /* 

2 pad2 (13) fixed bin (35), 

2 free_space fixed bins /* 



Syserr severity for recoverable MCS errors */ 

Lock owned by mcs_tlmer */ 
Offset of next timer to come due */ 
Number of timers outstanding */ 
Who is doing timers? */ 

How get get him */ 

CPU time spent spinning on timer lock */ . 

Number of times timer lock locked */ 

Number of times imer lock waited on */ 

CPU time spent in call side timer operations */ 

CPU time spent polling (including channel_manager) */ 
Number of calls to mcs_tlmer$set, set_wlred */ 
Number of calls to mcs_timer$reset, reset_wlred */ 

Number of calls to mcs_tiraer$change, change_wired */ 
Number of calls to mcs_timer$poll */ 

Number of mcs_timer calls ending with recoverable errors */ 
Number of timer polling found in progress on other CPU */ 

to prevent contention in allocating/freeing in tty_area */ 



start of free space region */ 



V, include hc_fast_locks 

/* END INCLUDE FILE ... tty_buf.incl.pll */ 
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tty_buffer_block. incl .pll 



segment In: >ldd> include contents modified: 06/18/81 0900.8 

entry modified: 06/21/85 1915.2 



/* BEGIN INCLUDE FILE ... tty_buffer_block. incl .pll */ 
/* 

Separated from tty_buf . incl .pll aug 78 by J. Nicholls 

Modified May 1979 by Larry Johnson to add max_buf f er_tally array and to use unsigned variables, 



*/ 

del blockp ptri 

del free_blockp ptrj 



del 1 free_block aligned based (f ree_blockp) , 
2 next bit (18) , 
2 size fixed bint 



del 1 
2 
2 



buffer based (blockp) aligned, 
next fixed bin (18) unal uns, 
flags unaligned, 

3 end_of_page bit (1) unaligned, 
3 converted bit (1) unaligned, 
3 break bit (1) unaligned, 
3 mark bit (1) unaligned, 
3 pad bit (2) unaligned, 
size_code fixed bin (3) unal uns, 
tally fixed bin (9) unal uns, 
chars (0:59) char (1) unaligned) 



* pointer which block entry is based on */ 

* pointer to head of free space chain */ 



* format of start of free block */ 

* foward pointer to next free block */ 

* number of words in this block */ 



* buffer definition */ 

* addr of next buffer */ 

* buffer contains end of page */ 

* buffer contains converted input */ 

* buffer contains break character */ 

* buffer contains first character after "mark" */ 

* (nwords/16) - 1 */ 

* number of characters in buffer */ 

* room for 60 data characters */ 



/* the following array, if indexed by buf f er . sizecode will give maximum number of characters permitted in that buffer */ 
del max_buffer_tally (0:7) fixed bin int static options (constant) init (60, 124, 188, 252, 316, 380, 444, 508) i 
/* END INCLUDE FILE ... tty_buffer_block. incl .pll */ 
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wtcb . incl .pll 



segment ins >ldd> include contents modified: 01/30/85 1523.9 

entry modified: 06/21/85 1920.0 



/* BEGIN INCLUDE FILE 



wtcb. incl .pll */ 



/* 



Moved from tty_buf. incl .pll Aug 78 by J. Nicholls plus changes for ring 0 demultiplexing 
Error code added Nov. 1982 by Robert Coren 

Modified December 1984 by Robert Coren to invent "more_flaga" structure and 
its first flag, line_status_disabled 



del wtcbp ptr; 



/* pointer to head of wtcb */ 



del 1 wtcb based (wtcbp) aligned, 

2 hevent fixed bin (71) aligned, 
2 event fixed bin (71) aligned, 

2 llne_status bit (72) aligned, 

2 tcb_ptr ptr unal, 
2 padl fixed bin (35), 

2 hproc bit (36) aligned, 
2 uproc bit (36) aligned, 

2 baud_rate fixed bin (18) unal uns, 
2 line_type fixed bin (18) unal uns, 

2 flags unaligned, 

3 listen bit (1) unaligned, 
3 dialed bit (1) unaligned, 
3 send_output bit (1) unaligned, 

3 qenable bit (1) unaligned, 

3 qflag bit (1) unaligned, 

3 end_frame bit (1) unaligned, 

3 notify_reqd bit (1) unaligned, 
3 work_reqd bit (1) unaligned, 
3 dialing bit (1) unaligned, 

3 dial_status_valid bit (1) unaligned, 
3 input_ava liable bit (1) unaligned, 
3 tcb_initialized bit (1) unaligned, 

3 wflag bit (1) unaligned, 
3 rflag bit (1) unaligned, 
3 wru bit (1) unaligned, 

3 hndlquit bit (1) unaligned, 

3 count_lines bit (1) unaligned, 

3 line_status_present bit. (1) unaligned, 



* wired terminal control block */ 

* event channel for hangup/dialup signal */ 

* users event channel, for uproc */ 

* actual line status sent by fnp */ 

* pointer to tcb */ 

* formerly time dialedup */ 

* boss processid */ 

* tty user processid */ 

* baud rate of this line */ 

* line type for line protocol */ 



* if on, listen for dialups */ 

* if on, line is dialed up */ 

* on if DN355 requested more output */ 

* if on, signal quits */ 

* on after quit, causes writes to be ignored */ 

* write chain fills ards frame */ 

* if on, do notify after unlocking lock */ 

* If on, call dn355 before returning */ 

* if on, 355 is dialing a phone number */ 

* if on, diai_status_code is valid */ 

* input for this device is waiting in wired space */ 

* if on, tcb has been initialized */ 

* process blocked on output */ 

* process blocked on Input */ 

* reading answerback */ 

* on if In hndlquit mode */ 

* on if tcb.llnemax > 0 */ 

* fnp has sent line status */ 



* . incl 



wtcb. incl .pll 



Page 14 



3 sync_line bit (1) unaligned, 
3 breakall bit (1) unaligned, 
3 scroll bit (1) unaligned, 

3 negotiating echo bit (1) unaligned, 

3 wake_tbl bit (1) unaligned, 

3 allow_wakeup bit (1) unaligned, 

3 receive_mode_device bit (1) unaligned, 
3 mark_set bit (1) unal, 
3 masked bit (1) unal, 

2 dial_status_code fixed bin (8) unaligned, 

2 fblock fixed bin (17) unaligned, 
2 lblock fixed bin (17) unaligned, 

2 fchar fixed bin (9) unsigned unaligned, 
2 actline fixed bin (9) unsigned unaligned, 
2 actcol fixed bin (9) unsigned unaligned, 
2 nramsgs fixed bin (9) unsigned unaligned, 

2 write_first fixed bin (17) unaligned, 

2 write_last fixed bin (17) unaligned, 

2 write_cnt fixed bin (17) unaligned, 

2 white_col fixed bin (17) unaligned, 

2 max_buf_size fixed bin (9) unal una, 

2 buffer_pad fixed bin (9) unal uns, 

2 devx fixed bin (17) unaligned, 

2 echdp bit (18) unaligned, 

2 vaketp bit (18) unaligned, 

2 prompt_len fixed bin (8) unaligned, 

2 prompt char (3) unaligned, 

2 line_delimiter char (1) unal, 

2 more_flags unaligned, 

3 line_status__disabled bit (1) unaligned, 

3 pad bit (26) unal, 

2 error_code fixed bin (35), 

2 pad2 bit (36) ii 

/* Ends on doubleword boundary */ 

/* END INCLUDE FILE ... wtcb. incl .pll */ 



/* channel is synchronous line type */ 
/* channel Is in breakall mode */ 
/* channel is In scroll mode */ 

/* ring zero to echo chars. */ 
/* on if in wake_tbl mode */ 

/* on to allow input wakeup in wake_tbl mode */ 

/* device must be told to enter receive mode */ 
/* write_with_mark call outstanding */ 
/* channel masked by FNP */ 

/* code returned by 355 after dialing a phone number */ 

/* oldest read pointer, block */ 
/* newest read block */ 

/* first block char index */ 

/* line number of current line */ 

/* tty column position */ 

/* current number of read-ahead msgs */ 

/* first write block */ 

/* last write block */ 

/* count of chars in write chain */ 

/* column position resulting from trailing white space */ 

/* maximum-size buffer to be allocated for this channel */ 

/* amount of pad to be left in output buffers */ 

/* index into let of channel's entry */ 

/* echo negotiation data ptr */ 

/* wakeup table offset */ 

/* number of chars in prompt string */ 

/* text of prompt message */ 

/* line delimiter for tty_read parse */ 

/* in addition to flags (above) */ 

/* "l"b => don't relay line_status interrupts */ 

/* error code returned by channel_manager to tty_interrupt */ 
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